MCP_3 项目说明

项目概述

MCP_3是一个基于Model Context Protocol (MCP)的应用框架，用于构建能够与外部资源和工具交互的AI系统。该项目提供了论文搜索与管理、天气查询等功能，展示了MCP在实际应用中的使用方式。

目录结构

MCP_3/
├── papers/                  # 论文存储目录
│   ├── ai_courses_and_specializations/  # AI课程与专业化论文
│   └── few-shot/           # Few-shot学习论文
├── __init__.py             # 包初始化文件
├── client.py               # MCP客户端实现demo
├── mcp_chatbot.py          # MCP聊天机器人
├── mcp_summary.md          # MCP论文摘要
├── readme.md               # 项目说明文档
├── server.py               # 主MCP服务器
├── server_config.json      # MCP服务器配置
└── weather_server.py       # 天气服务MCP服务器

安装说明

克隆或下载项目到本地
安装必要的依赖：

pip install -r requirements.txt

配置说明

server_config.json

配置文件定义了MCP服务器的连接参数：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "MCP_3"]
    },
    "research": {
      "command": "uv",
      "args": ["run", "MCP_3/server.py"]
    },
    "fetch": {
      "command": "uvx",
      "args": ["mcp-server-fetch"]
    }
  }
}

使用方法

启动服务器

主服务器

uv run MCP_3/server.py

检查服务器

使用MCP检查器查看服务器提供的工具和资源：

# 本地检查服务器
npx @modelcontextprotocol/inspector uv run MCP_3/server.py

# 远程检查服务器
修改server.py启动命令后运行
npx @modelcontextprotocol/inspector

使用聊天机器人

启动MCP聊天机器人进行交互式操作：

uv run MCP_3/mcp_chatbot.py

聊天机器人命令

@folders - 查看可用的论文主题
@<topic> - 搜索特定主题的论文
/prompts - 列出可用的提示词
/prompt <name> <arg1=value1> - 执行提示词
quit - 退出聊天机器人

功能介绍

1. 论文搜索与管理

主服务器提供以下工具：

search_papers(topic, max_results) - 搜索特定主题的论文
extract_info(paper_id) - 提取特定论文的详细信息
get_weather(city) - 获取指定城市的天气信息
add(a, b) - 将两个整数相加

2. 资源与提示词

资源

papers://folders - 论文主题目录资源
papers://<topic> - 特定主题的论文资源

提示词

generate_search_prompt(topic, num_papers) - 生成用于搜索和分析论文的提示词

示例

搜索论文

Query: search for paper on few-shot

搜索论文并保存摘要

Query: search for paper on few-shot，save the content in the file "mcp_summary.md"

获取天气信息

Query: Get weather forecast for New York

获取天气警报

Query: Get weather alerts for California

开发说明

添加新的MCP工具

在服务器文件中使用@mcp.tool()装饰器添加新工具：

@mcp.tool()
def new_tool(param1, param2):
    """工具描述"""
    # 工具实现
    return result

添加新的MCP资源

在服务器文件中使用@mcp.resource()装饰器添加新资源：

@mcp.resource(uri="resource://name")
def get_resource():
    """资源描述"""
    # 资源实现
    return resource_content

许可证

MIT License

MCP_3