MCP Server Tutorial 7f7

🚀 MCP 服務器教程

本倉庫提供了一個藉助 FastMCP 搭建的簡易 MCP（模型上下文協議）服務器。該服務器將多種數學運算作為工具對外提供，可通過 MCP 協議來調用。

🚀 快速開始

先決條件

• Python 3.8 或更高版本
• FastMCP 庫

安裝

1. 克隆此倉庫。
2. 創建並激活虛擬環境：

   uv venv
   source venv/bin/activate  # 在 Windows 上：vvenv\Scripts\activate
   

3. 安裝依賴項：

   uv install fastmcp
   

運行服務器

使用以下命令運行服務器：

python main.py

該服務器默認採用 SSE（服務器發送事件）傳輸，所以您能夠使用 MCP Inspector 進行連接。

與 MCP Inspector 連接

1. 打開 MCP Inspector：

npx @modelcontextprotocol/inspector

2. 選擇 SSE 傳輸類型。
3. 連接到服務器 URL（通常為 http://localhost:8000/sse）。
4. 此時您就可以和服務器定義的數學工具及資源展開交互。

✨ 主要特性

• 基本算術運算：涵蓋加法、減法、乘法、除法。
• 高級數學函數：
  • 次方
  • 平方根
  • 立方根
  • 階乘
  • 對數
  • 三角函數（正弦、餘弦、正切）
  • 取模
• 動態問候資源

💻 使用示例

可用工具

• add(a, b): 實現兩個數字相加。
• subtract(a, b): 完成兩個數字相減。
• multiply(a, b): 進行兩個數字相乘。
• divide(a, b): 把一個數字除以另一個數字。
• power(a, b): 計算 a 的 b 次方。
• sqrt(a): 計算數字的平方根。
• cbrt(a): 計算數字的立方根。
• factorial(a): 計算數字的階乘。
• log(a): 計算數字的自然對數。
• remainder(a, b): 計算 a 除以 b 的餘數。
• sin(a): 計算數字的正弦值。
• cos(a): 計算數字的餘弦值。
• tan(a): 計算數字的正切值。

可用資源

• greeting://{name}: 返回針對給定名稱的個性化問候語。

📚 詳細文檔

修改服務器

若要添加更多工具和資源，可依照 main.py 中的模式操作：

1. 若要添加新工具，使用 @mcp.tool() 裝飾器。
2. 若要添加新資源，使用 @mcp.resource() 裝飾器。

傳輸選項

FastMCP 支持兩種傳輸協議：

• stdio: 標準輸入/輸出（基於終端）
• sse: 服務器發送事件（基於瀏覽器，與 MCP Inspector 兼容）

若要更改傳輸協議，修改 mcp.run() 調用中的 transport 參數即可。