Dockerized MCP Server Template

🚀 Dockerized MCP 服務器模板

本倉庫提供了一個可複用的模板，用於藉助 Docker 容器運行的 Python 服務器實現模型上下文協議 (MCP)，並運用 Server-Sent Events (SSE) 實現即時通信。該模板基於 FastMCP 庫構建，能輕鬆實現與大型語言模型 (LLMs) 的集成。

🚀 快速開始

使用 Docker Compose 構建和運行

docker-compose up --build

服務器可通過以下地址訪問：

http://localhost:3000/sse

直接運行（不使用 Docker）

也能直接使用 Python 運行服務器。首先安裝依賴項：

pip install -r src/requirements.txt

然後運行服務器：

python src/server.py

服務器可通過以下地址訪問：

http://localhost:3000/sse

✨ 主要特性

• 提供可重用模板，用於運行實現 MCP 的 Python 服務器。
• 基於 Docker 容器，便於部署和管理。
• 利用 Server-Sent Events (SSE) 實現即時通信。
• 基於 FastMCP 庫，方便與大型語言模型集成。

📦 安裝指南

使用 Docker Compose

docker-compose up --build

不使用 Docker

pip install -r src/requirements.txt

💻 使用示例

基礎用法

@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers"""
    return a + b

您可以通過 MCP 客戶端請求調用此工具。

📚 詳細文檔

什麼是 MCP？

模型上下文協議 (MCP) 是專門為與大型語言模型交互而設計的標準協議。MCP 允許應用程序明確區分向 LLM 提供上下文（數據和功能）與實際的 LLM 交互這兩個關注點。MCP 服務器提供：

• 資源：向 LLM 提供數據（類似於 GET 端點）。
• 工具：允許 LLM 執行操作或計算（類似於 POST 端點）。
• 提示模板：用於與 LLM 結構化交互的可重用模板。

此模板展示了在 Docker 容器中運行的生產就緒 MCP 服務器，並利用 Server-Sent Events (SSE) 進行即時通信。

項目結構

dockerized-mcp-server-template/
├── src/
│   ├── Dockerfile
│   ├── requirements.txt
│   └── server.py
├── docker-compose.yml
└── README.md

📄 資源

• MCP 文檔
• MCP 規範
• Server-Sent Events (SSE)