MCP Examples

🚀 MCP示例項目

本項目展示了一個模型上下文協議（MCP）的服務器和客戶端設置，包含在Docker容器中運行服務器所需的工具和配置。

📦 安裝指南

構建Docker鏡像

從項目根目錄運行以下命令：

docker build -t mcp-example-stdio-server:latest .

這將創建一個名為 mcp-example-stdio-server:latest 的Docker鏡像，其中包含MCP服務器。

獨立運行服務器

可以直接運行以下命令啟動服務器：

docker run --rm -i mcp-example-stdio-server:latest

服務器將啟動並監聽MCP標準輸入輸出請求。

💻 使用示例

mcp.json 配置

.vscode/mcp.json 文件用於配置在開發環境（如VS Code）中如何啟動MCP服務器：

{
  "servers": {
    "example-mcp-server": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "mcp-example-stdio-server:latest"
      ]
    }
  },
  "inputs": []
}

• type：stdio 表示服務器通過標準輸入輸出進行通信。
• command：用於啟動服務器的命令（docker）。
• args：運行帶有已構建鏡像的Docker容器的參數。

這種設置允許開發工具在容器化環境中自動啟動MCP服務器。

📚 詳細文檔

項目結構

.
├── Dockerfile                # MCP服務器的Docker構建指令
├── pyproject.toml            # Python項目配置
├── uv.lock                   # 依賴項的鎖文件
├── README.md                 # 項目文檔
├── client/                   # 客戶端代碼（如果有）
└── servers/                  # MCP服務器實現
    ├── __init__.py
    ├── main.py               # 服務器的主入口點
    └── tools/                # 額外的服務器工具
        ├── __init__.py
        ├── calendar.py       # 日曆工具實現
        ├── task_manager.py   # 任務管理器工具實現
        └── weather.py        # 天氣工具實現

🔧 技術細節

• 確保系統上已安裝並運行Docker。
• 在對服務器代碼進行更改後，根據需要通過重新構建鏡像來更新Docker鏡像。
• servers/tools/ 目錄包含模塊化的工具實現，可以根據需要進行擴展。