🚀 MCP 学习项目⚡

本项目是一个基于MCP协议的学习项目，主要用于探索MCP Server的实现方法。项目涵盖了API服务接口、单元测试程序以及MCP Server的两种实现方式，能帮助开发者熟悉相关技术和开发流程。

🚀 快速开始

首先，安装项目所需的依赖：

pip install -r requirements.txt

启动API服务：

# 进入api_server目录下
python main.py

启动MCP Server（根据选择的实现方式）：

# 对于stdio方式
cd mcp_server
python server.py

# 对于sse方式
cd mcp_server
python remote_server.py

最后，配置并使用cline进行测试。

✨ 主要特性

• 四则运算工具集：实现加、减、乘、除等基本运算。
• 基于SSE的实时传输：支持服务器端推送事件。
• 异步支持：提高系统的响应速度和处理能力。
• 强类型输入校验：确保数据的有效性和安全性。

📦 安装指南

安装项目依赖，只需执行以下命令：

pip install -r requirements.txt

💻 使用示例

第一种是stdio方式

主要是本地调用、本地运行的方式，主要实现包含在server.py代码中。 使用方式可以使用cline插件进行调用，下面附上cline调用的cfg配置：

{
  "mcpServers": {
    "math": {
      "timeout": 60,
      "command": "mcp",
      "args": [
        "run",
        "\mcp_server\server.py"
      ],
      "transportType": "stdio",
      "disabled": true
    }
  }
}

stdio运行方式

# 进入api_server目录下
python main.py
# 启动api 服务

# 配置好cline的cfg后
# 在cline中测试mcp server

第二种是sse方式

使用uvicorn生成一个服务，使用cline插件的remote server方式进行配置连接。 主要功能包含在remote_server.py中，下面附上cline的cfg配置：

{
  "mcpServers": {
    "calculate": {
      "autoApprove": [
        "calculate_sum",
        "calculate_subtract",
        "calculate_multiply",
        "calculate_divide"
      ],
      "disabled": false,
      "timeout": 60,
      "url": "http://127.0.0.1:8001/sse",
      "transportType": "sse"
    }
  }
}

sse运行方式

# 进入api_server目录下
python main.py
# 启动api 服务

# 进入mcp_server目录下
python remote_server.py
# 启动mcp server

# 配置好cline的cfg后
# 在cline中测试mcp server

📚 详细文档

项目结构

• api_server目录：是一个使用FastAPI库实现的一组API服务接口，用来模拟现有系统的java后端服务，本项目内只是实现了加减乘除四则运算。
• tests目录：是一个针对api_server的单元测试程序，用来熟悉pytest功能。
• mcp_server目录：是MCP的server内容，包含MCP的两种实现方式。

🔧 技术细节

系统架构

Client通过SSE与MCP Server通信，后者通过HTTP RPC调用API Server进行计算。

技术栈

• Starlette：一个轻量级的ASGI框架，用于构建高性能的Web应用。
• Uvicorn：一个快速的ASGI服务器，支持异步处理。
• HTTPX：一个异步HTTP客户端库，用于发送HTTP请求。
• MCP协议：通过Server-Sent Events实现流数据传输。

通过本项目，您可以学习如何基于MCP协议实现一个分布式计算服务，并掌握相关的技术栈和开发方法。