Fast MCP Server

🚀 快速 MCP 服務器

本項目是一個輕量級的 MCP（模型上下文協議）服務器實現，通過 SSE 接口將自定義工具暴露出來，可與 AI 客戶端實現無縫集成，為用戶提供便捷的工具調用體驗。

🚀 快速開始

此倉庫提供了一個簡單的 MCP 服務器，能實現自定義工具（如天氣預警和預報），並通過 SSE 接口將其暴露。它可藉助 Docker 容器快速部署，與支持 MCP 協議的客戶端無縫集成。 克隆倉庫並進入項目目錄：

git clone git@github.com:kongo97/fast-mcp-server.git
cd fast-mcp-server

構建 Docker 鏡像

docker compose build

此命令會使用提供的 Dockerfile 為 MCP 服務器構建 Docker 鏡像。

啟動容器

docker compose up -d

此命令將執行以下操作：

• 拉取/構建鏡像
• 以分離模式啟動容器
• 將主機的端口 8100 映射到容器的端口 8100

若要停止並刪除容器，請運行：

docker compose down

✨ 主要特性

• 通過 SSE 接口將自定義工具作為 MCP 端點暴露出來。
• 利用 Docker Compose 進行容器化，便於快速部署。
• 支持端口和主機地址的配置。
• 包含示例工具（如天氣預警和預報）。

📦 安裝指南

先決條件

• Docker ≥ 20.10
• Docker Compose ≥ 1.29

💻 使用示例

連接 MCP 客戶端

配置您的 MCP 兼容客戶端（如 Claude Desktop），通過 SSE 接口連接到以下地址：

http://localhost:8100/sse

在 docs 文件夾中，您能找到與 Claude Desktop 配合使用的簡單配置示例（claude_desktop_config.json）。

可用端點

📚 詳細文檔

配置

您可通過在 docker-compose.yml 或直接在容器中設置環境變量，來自定義服務器端口和主機地址：

services:
  mcp-server:
    environment:
      - MCP_PORT=8100         # 默認端口
      - MCP_HOST=0.0.0.0      # 綁定地址

開發

1. 在 src/server.py（或其他您選擇的文件）中編輯或添加您的 MCP 工具。
2. 重建並重新啟動容器：

   docker compose build
   docker compose up -d
   

3. 檢查日誌中的錯誤信息：

   docker compose logs -f
   

故障排除

• 訪問 /sse 時返回 404：請確保服務器已綁定到正確的端口和路徑。
• 連接被拒絕：請驗證 Docker 是否在運行且容器狀態正常：

  docker ps
  docker logs simple-mcp-server
  

• 客戶端錯誤：檢查客戶端配置中的 SSE URL 和協議版本是否正確。

📄 許可證

文檔中未提及具體的許可協議內容。若您需要了解，請進一步查閱相關資料。