🚀 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 进行测试

配置好 cline 后，即可在 cline 中测试 mcp server。

✨ 主要特性

四则运算工具集：实现加、减、乘、除等基本运算。
基于 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 的两种实现方式。