Simple MCP Server

🚀 簡單 MCP 服務器

這是一個輕量級的 MCP（模型上下文協議）服務器實現，藉助 SSE 提供自定義工具，可與 AI 客戶端實現無縫集成，為用戶帶來便捷的使用體驗。

🚀 快速開始

此倉庫提供了一個簡單的 MCP 服務器，能實現自定義工具（如天氣警報），並通過 SSE 推送事件。它支持使用 Docker 容器快速部署，可與支持 MCP 協議的客戶端完美集成。

首先，克隆倉庫並進入項目目錄：

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

構建 Docker 鏡像

docker compose build

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

啟動容器

docker compose up -d

該命令會執行以下操作：

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

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

docker compose down

✨ 主要特性

• 通過 SSE 推送事件，將自定義工具作為 MCP 端點暴露出來。
• 支持使用 Docker Compose 進行容器化部署，方便快速啟動和運行。
• 端口和主機均可進行配置。
• 已包含示例工具（如天氣警報和預報）。

📦 安裝指南

先決條件

• Docker ≥ 20.10
• Docker Compose ≥ 1.29

💻 使用示例

連接 MCP 客戶端

配置您的 MCP 兼容客戶端（如Claude桌面版）通過 SSE 連接到：

http://localhost:8100/sse

在 docs 文件夾中，您能找到一個與 Claude 桌面兼容的簡單配置（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
   

故障排除

• 404 在 /sse：請確保服務器綁定到正確的端口和路徑。
• 連接被拒絕：確認 Docker 正在運行且容器狀態正常：

  docker ps
  docker logs simple-mcp-server
  

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

📄 許可證

文檔中未明確提及具體的許可證內容。