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 开发文档