MCP Server Example

🚀 🧠 使用 Python 創建 MCP 服務器 - 實用教程

本倉庫詳細展示瞭如何藉助微軟官方 SDK，使用 Python 構建一個 MCP（模型上下文協議）服務器。該項目著重演示瞭如何定義工具 (@tool)，這些工具可被 ChatGPT 或 Open WebUI 環境中的其他大型語言模型調用，為開發者提供了便捷的集成方案。

🚀 快速開始

本項目使用了以下技術來創建 MCP 服務器：

• Python 3.10+
• uv - 用於管理環境和包
• mcp - 微軟官方 MCP SDK
• mcpo - HTTP 中間件 + OpenAPI 文檔

📦 安裝指南

# 1. 使用 uv 創建虛擬環境
uv venv .venv
source .venv/bin/activate

# 2. 安裝 MCP SDK、CLI 和 mcpo
uv add mcp mcp[cli] mcpo

📚 詳細文檔

🧩 項目結構

📁 項目/
├── main.py         # 主文件，包含 MCP 服務器
├── README.md       # 此文件
└── .venv/          # 虛擬環境（無需版本控制）

💻 使用示例

基礎用法

以下是主文件 main.py 中的代碼示例，展示瞭如何定義工具和啟動 MCP 服務器：

from mcp.server.fastmcp import FastMCP

mcp = FastMCP("教程 MCP 服務器")

@mcp.tool()
def get_tutorial_summary():
    """
    返回關於如何構建 MCP 服務器的教程摘要。

    :return: 文本形式的教程摘要。
    """
    return (
        "使用 uv 配置環境。\n"
        "安裝命令：uv add mcp mcp[cli] mcpo\n"
        "實現帶有 @tool 的函數\n"
        "運行方式：mcpo\n"
        "通過 MCP 客戶端或 Open WebUI 消費。"
    )

@mcp.tool()
def somar(a: int, b: int) -> int:
    """
    返回兩個整數的和。

    :param a: 第一個數字。
    :param b: 第二個數字。
    :return: a 和 b 的結果之和。
    """
    return a + b

if __name__ == "__main__":
    mcp.run(transport="stdio")  # 本地運行

▶️ 如何運行

本地模式（stdio）

.venv/bin/python main.py

或者

mcp run main.py # 以標準方式運行服務器

mcp dev main.py # 以開發人員模式測試服務器

mcp install main.py # 在 Claude Desktop 上本地安裝

此模式適用於與 MCP CLI 進行本地測試。

使用 mcpo 的 HTTP 模式（OpenAPI 文檔）

mcpo --port 8000 -- .venv/bin/python main.py

• 自動在文檔中出現。
• 成為 LLM 使用的依據，基於用戶的查詢。

🔥 清晰的 docstring 可以顯著提升與 LLM 的交互體驗。

📢 貢獻

歡迎提交 Pull requests！你可以隨意提交新的工具、改進示例或擴展教程，共同完善這個項目。