Hello MCP Server Python

🚀 MCP 服務器文檔

本項目藉助 Model Context Protocol (MCP) 構建服務器端工具，為 Claude AI 等大型語言模型提供功能支持。當前，服務器主要提供 BMI 計算與天氣信息查詢兩項服務。

🚀 快速開始

你可以按照以下步驟快速啟動 MCP 服務器：

1. 克隆代碼倉庫：

   git clone https://github.com/yourusername/hello-mcp-server-python.git
   cd hello-mcp-server-python
   

2. 安裝依賴項：

   pip install httpx "mcp[cli]"
   

3. 啟動服務器（可選，通過 MCP 或命令行運行）：

   python server.py
   # 或使用 MCP CLI
   mcp run server.py
   

✨ 主要特性

• 功能豐富：提供 BMI 計算和天氣信息查詢兩項實用功能。
• 兼容性好：支持 Linux、macOS 和 Windows 系統，不過 Windows 部分功能可能受限。
• 靈活啟動：可通過 MCP 或命令行啟動服務器。

📦 安裝指南

系統要求

• 操作系統：建議使用 Linux 或 macOS，Windows 也可運行但部分功能可能受限。
• Python 版本：3.9 及以上版本。
• 開發環境：具備基本的 Python 和命令行操作知識。

安裝步驟

1. 克隆代碼倉庫：

   git clone https://github.com/yourusername/hello-mcp-server-python.git
   cd hello-mcp-server-python
   

2. 安裝依賴項：

   pip install httpx "mcp[cli]"
   

3. 服務器啟動（可選，通過 MCP 或命令行運行）：

   python server.py
   # 或使用 MCP CLI
   mcp run server.py
   

💻 使用示例

基礎用法

BMI 計算

calculate_bmi --height 170 --weight 65

此命令將根據輸入的身高（170cm）和體重（65kg）計算 BMI 值並輸出結果。

天氣查詢

fetch_weather --city "北京"

該命令會查詢北京的天氣信息並返回詳情。

📚 詳細文檔

服務器配置

MCP 配置文件 (mcp.json)

在項目根目錄下創建或修改 mcp.json 文件，添加以下內容以配置服務器：

{
  "mcpServers": {
      "mcp-server-python": {
            "command": "mcp",
            "args": [
                "run",
                "/path/to/server.py"
                ]
      }
  }
}

命令行運行

直接在終端執行以下命令啟動服務器：

python server.py

環境變量配置

API 密鑰設置

在 server.py 中添加以下代碼以配置天氣 API 的密鑰：

API_KEY = "your_api_key_here"  # 替換為實際的 API 密鑰

項目結構

hello-mcp-server-python/
├── server.py       # MCP 服務器主程序文件
└── requirements.txt  # 依賴項管理文件（可選）

使用說明

通過 MCP 連接

1. 打開 Cursor IDE，加載項目。
2. 確保 mcp.json 文件存在且配置正確。
3. 在 Cursor 中運行服務器，MCP 工具將自動識別並可用。

通過命令行使用

1. 安裝 Claude for Desktop。
2. 在終端中啟動服務器：

python server.py

3. 在 Claude 界面中訪問 MCP 服務器進行交互。

常見問題解答

• 如何獲取天氣 API 密鑰？

  • 可聯繫相關天氣服務提供商申請免費試用密鑰。

• 服務器啟動失敗怎麼辦？

  • 檢查網絡連接和依賴項是否安裝正確，查看終端輸出的錯誤信息。

📄 許可證

本項目遵循 MIT 許可證協議。詳細內容請參閱 LICENSE 文件。

🔗 參考資料

• Model Context Protocol 文檔
• MCP Python SDK 文檔
• httpx 官方文檔
• Claude AI 開發文檔