Introduction To MCP

🚀 MCP 入門介紹

本項目提供了一個最小的 MCP 服務器和客戶端示例，主要演示了藉助 SSE（Server-Sent Events）和 stdio 傳輸實現的基本計算器操作，能幫助開發者快速瞭解 MCP 的使用。

🚀 快速開始

📦 安裝指南

通過 pip 從 requirements.txt 文件安裝所有包。可以在終端中運行以下命令：

pip install -r requirements.txt

🏃‍♂️ 運行服務器

首先，確保已經安裝了 mcp 包。可以通過運行以下命令來實現：

pip install mcp[cli]

然後，可以使用以下命令運行 server.py 腳本：

mcp dev server.py

也可以直接使用 Python 運行 server.py：

python server.py

• 使用 python server.py 以正常模式運行。
• 使用 mcp dev server.py 進行開發，享受熱重載和更好的開發體驗。

⚠️ 重要提示

當您運行 mcp dev server.py 時，啟動的是 MCP Inspector 及其代理服務器（默認端口 6277），而不是直接運行您在 server.py 中定義的 FastMCP 服務器。MCP Inspector 使用的端口是 6277，默認情況下不會使用 server.py 指定的 8050 端口。

如果希望您的 FastMCP 服務器監聽 server.py 中定義的 8050 端口，應執行：python server.py

mcp dev 命令專為開發和調試 MCP Inspector 設計。如果您想連接到 Inspector，請使用代理端口（6277）。如果希望您的服務器偵聽 8050 端口，則直接運行 python server.py。

💻 運行客戶端

STDIO 客戶端

將服務器作為子進程啟動，並通過 stdio 傳輸連接到它。這對於測試和調試很有用。

python client_stdio.py

SSE 客戶端

通過 sse 傳輸連接到服務器。這適用於即時更新和通知。

python client_sse.py

🔗 鏈接

• 服務器開發快速入門
• 客戶端開發快速入門