Simple MCP Server With Python

🚀 使用 Python MCP SDK 構建簡單的服務器

本教程將指導你使用 Model Context Protocol (MCP) Python SDK 構建一個簡單的服務器。我們會逐步帶你完成服務器的安裝、設置和運行，並展示如何通過命令行與之交互。

🚀 快速開始

安裝 MCP Python SDK

首先，在項目環境中安裝 MCP Python SDK：

pip install mcp-sdk

創建基本服務器配置文件 (server.py)

創建一個新的 Python 文件 server.py，並添加以下代碼：

# server.py
from mcp import Server, StdioTransport

if __name__ == "__main__":
    # 初始化 MCP 服務器
    server = Server()
    
    @server.tool("add")
    async def add_tool(arguments):
        a = arguments["a"]
        b = arguments["b"]
        return f"{int(a) + int(b)}"
    
    @server.resource("greeting://{name}")
    async def greeting_resource(name):
        return f"Hello, {name}!"
    
    # 使用標準輸入輸出作為默認傳輸協議
    transport = StdioTransport()
    server.start(transport)

運行服務器

在終端中運行以下命令啟動服務器：

python server.py

此時，服務器將在後臺靜默運行，等待客戶端連接併發送請求。

創建 MCP 客戶端 (client.py)

創建另一個 Python 文件 client.py，添加以下代碼以連接到服務器：

# client.py
import asyncio
from mcp import Server, ClientSession, StdioServerParameters
from mcp.client.stdio import stdio_client

async def main():
    server_params = StdioServerParameters(
        command="python",
        args=["server.py"],
    )

    async with stdio_client(server_params) as (reader, writer):
        async with ClientSession(reader, writer) as session:
            await session.initialize()

            # 調用 add 工具
            result = await session.call_tool("add", arguments={"a": 3, "b": 4})
            print(f"加法工具的結果: {result}")

if __name__ == "__main__":
    asyncio.run(main())

運行客戶端

在不同的終端窗口中運行以下命令啟動客戶端：

python client.py

輸出結果應為：

加法工具的結果: TextContent(type='text', text='7', annotations=None)

✨ 主要特性

擴展服務器功能

你可以通過添加更多工具和資源來擴展服務器的功能。例如，添加一個計算器工具：

@server.tool("calculator")
async def calculator_tool(arguments):
    operation = arguments["operation"]
    a = int(arguments["a"])
    b = int(arguments["b"])
    
    if operation == "add":
        return a + b
    elif operation == "subtract":
        return a - b
    elif operation == "multiply":
        return a * b
    elif operation == "divide":
        return a / b
    else:
        raise ValueError("無效的運算操作")

使用 MCP 檢查工具

MCP 提供了一個命令行工具 mcp-check 來驗證服務器是否正確運行。安裝並使用如下：

pip install mcp-check
mcp-check http://localhost:1234

📚 詳細文檔

附錄：常見問題解答

問：為什麼我的服務器沒有響應？

答：請確保服務器正在運行，並且客戶端連接到了正確的地址和端口。檢查是否有防火牆或網絡配置阻止了連接。

問：如何處理自定義資源？

答：你可以通過在服務器上註冊自定義資源路徑，例如 @server.resource("custom/{id}")，並返回相應的數據。

問：MCP 支持哪些傳輸協議？

答：除了標準輸入輸出之外，MCP 還支持 WebSocket 和 HTTP 等其他傳輸協議。你可以根據需求進行選擇和配置。

通過這篇教程，你已經掌握了使用 MCP Python SDK 構建基本服務器的技能。祝你在開發過程中取得成功！