MCP 服务器

MCP Server Python

jongkwang

开发者工具

访问服务器

README

MCP Server Python

语言: English | 韩语

English

一个使用模型上下文协议的 Python 服务器示例项目。

概述

本项目是一个服务器示例，它使用模型上下文协议 (MCP) 为 Claude AI 等 LLM 提供工具。它提供 BMI 计算和天气信息查询功能。

参考

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

Model Context Protocol Python SDK

先决条件

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

安装

克隆存储库：

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

安装所需的包：

pip install httpx "mcp[cli]"

运行服务器：（如果通过 Cursor 或 Claude for Desktop 连接，则可选）

python server.py
# 或
mcp run server.py

连接到 Cursor 和 Claude for Desktop

连接到 Cursor

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

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

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

连接到 Claude for Desktop

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

python server.py

转到 Claude for Desktop 设置中的 MCP 服务器部分，并添加本地 MCP 服务器。
根据需要配置服务器 URL 或端口。
与 Claude 聊天时，您可以使用 BMI 计算和天气查询工具。

项目结构

hello-mcp-server-python/
├── server.py       # MCP 服务器主文件
└── requirements.txt  # 依赖包列表（可选）

功能

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

calculate_bmi: 从身高和体重输入计算 BMI。
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을 활용한 Python 서버 예제 프로젝트입니다.

개요

이 프로젝트는 Model Context Protocol(MCP)을 사용하여 Claude AI와 같은 LLM에 도구(Tool) 기능을 제공하는 서버 예제입니다. BMI 계산과 날씨 정보 조회 기능을 제공합니다.

참조한 사이트 주소

이 프로젝트는 다음 오픈소스 프로젝트를 참고하여 만들어졌습니다:

Model Context Protocol Python SDK

사전 설치 사항

Python 3.9 이상
pip 또는 pip3 (패키지 관리자)
httpx (비동기 HTTP 클라이언트)
MCP Python SDK

설치 방법

저장소를 클론합니다:

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

필요한 패키지를 설치합니다:

pip install httpx "mcp[cli]"

서버 실행: (Cursor나 Claude for Desktop을 통해 연결하는 경우 이 단계는 선택 사항)

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

Cursor와 Claude for Desktop에 연결 방법

Cursor에 연결하기

Cursor IDE를 열고 프로젝트를 로드합니다.
Cursor 프로젝트 루트에 mcp.json 파일을 생성하고 다음 내용을 추가합니다:

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

Cursor에서 Claude와 채팅할 때 MCP 도구가 자동으로 인식됩니다. 서버는 mcp.json 설정에 따라 자동으로 실행됩니다.

Claude for Desktop에 연결하기

Claude for Desktop을 설치합니다.
터미널에서 서버를 실행합니다:

python server.py

Claude for Desktop 설정에서 MCP 서버 섹션으로 이동하여 로컬 MCP 서버를 추가합니다.
서버 URL 또는 포트를 필요에 따라 구성합니다.
Claude와 대화하면 BMI 계산과 날씨 조회 도구를 사용할 수 있습니다.

프로젝트 구조

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

기능

현재 서버는 두 가지 도구를 제공합니다:

calculate_bmi: 키와 몸무게를 입력받아 BMI를 계산합니다.
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