MCP Server Study

🚀 MCP學習項目⚡

本項目是一個基於MCP協議的學習項目，主要聚焦於MCP Server的實現學習。它包含API服務接口模擬、單元測試程序以及MCP Server的不同實現方式，能幫助開發者深入理解MCP協議。

🚀 快速開始

前提條件

• Python 3.10+

安裝依賴

pip install fastapi uvicorn pytest

運行項目

1. 啟動API服務（在api_server目錄下）

cd api_server && python main.py

2. 啟動MCP Server（在mcp_server目錄下）

cd mcp_server && python remote_server.py

3. 配置並使用cline插件進行測試

✨ 主要特性

• 🧮 四則運算工具集（加減乘除）
• 📡 基於SSE的即時消息傳輸
• ⚡ 異步HTTP客戶端支持
• 🔒 強類型輸入校驗

📦 安裝指南

前提條件

• Python 3.10+

安裝依賴

pip install fastapi uvicorn pytest

💻 使用示例

基礎用法

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方式

使用uvicon生成一個服務，使用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

📚 詳細文檔

本項目是一個基於MCP協議的學習項目，主要用於學習MCP Server如何實現。 api_server目錄內是一個使用FastAPI庫實現的一組API服務接口，用來模擬現有系統的java後端服務，本項目內只是實現了加減乘除四則運算。 tests目錄下是一個針對api_server的單元測試程序，用來熟悉pytest功能。 mcp_server目錄下是MCP的server內容，包含MCP的兩種實現方式。

🔧 技術細節

系統架構

graph LR
    Client-->|SSE 流式傳輸| MCP_Server["MCP Server (Port 8001)"]
    MCP_Server-->|HTTP RPC| API_Server["API Server (Port 8000)"]
    API_Server-.->|調用函數| FUNC[(計算函數)]
    
    subgraph 計算服務
        API_Server
    end

🛠️ 技術棧

• 框架: Starlette
• 服務器: Uvicorn
• HTTP客戶端: HTTPX
• 協議: MCP協議