MCP Server Python

MCP Server Python

语言：英语 | 韩语

英语

一个使用 Model Context Protocol 的 Python 服务示例项目。

目录

• 概览
• 参考项目
• 先决条件
• 安装
• 连接到 Cursor 和 Claude for Desktop
• 项目结构
• 功能
• 天气 API 设置
• 许可证
• 参考资料

概览

本项目是一个服务示例，使用 Model Context Protocol（MCP）为 Claude AI 等大模型提供工具。它提供 BMI 计算和天气信息查询功能。

参考项目

本项目基于以下开源项目创建：

• Model Context Protocol Python SDK

先决条件

• Python 3.9 或更高版本
• pip 或 pip3（包管理器）
• httpx（异步 HTTP 客户端）
• MCP Python SDK

安装

1. 克隆代码库：

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

2. 安装所需的包：

pip install httpx "mcp[cli]"

3. 运行服务：（如果通过 Cursor 或 Claude for Desktop 连接，则此步骤可选）

python server.py
# or
mcp run server.py

连接到 Cursor 和 Claude for Desktop

连接到 Cursor

1. 打开 Cursor IDE 并加载项目。
2. 在项目根目录中创建 mcp.json 文件，并添加以下内容：

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

3. 在 Cursor 中与 Claude 聊天时，MCP 工具会自动被识别。服务将根据 mcp.json 设置自动运行。

连接到 Claude for Desktop

1. 安装 Claude for Desktop。
2. 在终端中运行服务：

python server.py

3. 前往 Claude for Desktop 设置中的 MCP 服务部分，添加一个本地 MCP 服务。
4. 根据需要配置服务 URL 或端口。
5. 与 Claude 聊天时，可以使用 BMI 计算和天气查询工具。

项目结构

hello-mcp-server-python/
├── server.py       # MCP server main file
└── requirements.txt  # Dependency package list (optional)

功能

该服务目前提供两个工具：

1. calculate_bmi：根据身高和体重输入计算 BMI。
2. fetch_weather：获取指定城市名称对应的天气信息。（需要 API 密钥）

天气 API 设置

要使用天气 API，需要 API 密钥。打开 server.py 文件并按以下方式修改：

@mcp.tool()
async def fetch_weather(city: str) -> str:
    """Fetch current weather for a city"""
    API_KEY = "your_api_key_here"  # Enter your API key here
    async with httpx.AsyncClient() as client:
        response = await client.get(f"https://api.weather.com/{city}?apiKey={API_KEY}")
        return response.text

许可证

本项目根据 MIT License 分发。详情请参阅 LICENSE 文件。

参考资料

• Model Context Protocol 文档
• Model Context Protocol Python SDK 文档
• httpx 文档
• Claude AI 文档

---

韩语

这是一个使用 Model Context Protocol 的 Python 服务示例项目。

目录

• 概览
• 参考网站地址
• 先决条件
• 安装方法
• 连接到 Cursor 和 Claude for Desktop
• 项目结构
• 功能
• 天气 API 设置
• 许可证
• 参考文档

概览

本项目是一个服务示例，使用 Model Context Protocol（MCP）为 Claude AI 等大模型提供工具功能。它提供 BMI 计算和天气信息查询功能。

参考网站地址

本项目参考以下开源项目创建：

• Model Context Protocol Python SDK

先决条件

• Python 3.9 或更高版本
• pip 或 pip3（包管理器）
• httpx（异步 HTTP 客户端）
• MCP Python SDK

安装方法

1. 克隆代码库：

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

2. 安装所需的包：

pip install httpx "mcp[cli]"

3. 运行服务：（如果通过 Cursor 或 Claude for Desktop 连接，则此步骤可选）

python server.py
# 또는
mcp run server.py

连接到 Cursor 和 Claude for Desktop

连接到 Cursor

1. 打开 Cursor IDE 并加载项目。
2. 在 Cursor 项目根目录中创建 mcp.json 文件，并添加以下内容：

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

3. 在 Cursor 中与 Claude 聊天时，MCP 工具会自动被识别。服务将根据 mcp.json 设置自动运行。

连接到 Claude for Desktop

1. 安装 Claude for Desktop。
2. 在终端中运行服务器：

python server.py

3. 在 Claude for Desktop 设置中，前往 MCP 服务部分并添加本地 MCP 服务。
4. 根据需要配置服务器 URL 或端口。
5. 与 Claude 对话，即可使用 BMI 计算和天气查询工具。

项目结构

hello-mcp-server-python/
├── server.py       # MCP 서버 메인 파일
└── requirements.txt  # 의존성 패키지 목록 (선택 사항)

功能

当前服务器提供两种工具：

1. calculate_bmi：输入身高和体重，计算 BMI。
2. fetch_weather：输入城市名称，获取该城市的天气信息。（需要设置 API 密钥）

天气 API 设置

使用天气 API 需要 API 密钥。打开 server.py 文件并按如下方式修改：

@mcp.tool()
async def fetch_weather(city: str) -> str:
    """Fetch current weather for a city"""
    API_KEY = "your_api_key_here"  # 여기에 API 키를 입력하세요
    async with httpx.AsyncClient() as client:
        response = await client.get(f"https://api.weather.com/{city}?apiKey={API_KEY}")
        return response.text

许可证

本项目根据 MIT 许可证发布。详情请参阅 LICENSE 文件。

参考文档

• Model Context Protocol 文档
• Model Context Protocol Python SDK 文档
• httpx 文档
• Claude AI 文档