Cover image
Try Now
2025-04-09

3 years

Works with Finder

1

Github Watches

0

Github Forks

0

Github Stars

MCP Server Python

Languages: English | 한국어

English

A Python server example project using the Model Context Protocol.

Table of Contents

Overview

This project is a server example that provides tools to LLMs such as Claude AI using the Model Context Protocol (MCP). It offers BMI calculation and weather information lookup functions.

Reference

This project was created based on the following open source project:

Prerequisites

  • Python 3.9 or higher
  • pip or pip3 (package manager)
  • httpx (asynchronous HTTP client)
  • MCP Python SDK

Installation

  1. Clone the repository:
git clone https://github.com/yourusername/hello-mcp-server-python.git
cd hello-mcp-server-python
  1. Install the required packages:
pip install httpx "mcp[cli]"
  1. Run the server: (Optional if connecting through Cursor or Claude for Desktop)
python server.py
# or
mcp run server.py

Connecting to Cursor and Claude for Desktop

Connecting to Cursor

  1. Open Cursor IDE and load the project.
  2. Create an mcp.json file in the project root and add the following content:
{
  "mcpServers": {
      "mcp-server-python": {
            "command": "mcp",
            "args": [
                "run",
                "/_____PATH_OF_FILE_____/server.py"
                ]
      }
  }
}
  1. MCP tools will be automatically recognized when chatting with Claude in Cursor. The server will run automatically according to the mcp.json settings.

Connecting to Claude for Desktop

  1. Install Claude for Desktop.
  2. Run the server in the terminal:
python server.py
  1. Go to the MCP server section in Claude for Desktop settings and add a local MCP server.
  2. Configure the server URL or port as needed.
  3. When chatting with Claude, you can use the BMI calculation and weather lookup tools.

Project Structure

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

Features

The server currently provides two tools:

  1. calculate_bmi: Calculates BMI from height and weight inputs.
  2. fetch_weather: Retrieves weather information for a given city name. (API key required)

Weather API Setup

To use the weather API, you need an API key. Open the server.py file and modify it as follows:

@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

License

This project is distributed under the MIT License. See the LICENSE file for details.

References


한국어

Model Context Protocol을 활용한 Python 서버 예제 프로젝트입니다.

목차

개요

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

참조한 사이트 주소

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

사전 설치 사항

  • 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
  1. 필요한 패키지를 설치합니다:
pip install httpx "mcp[cli]"
  1. 서버 실행: (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"
                ]
      }
  }
}
  1. Cursor에서 Claude와 채팅할 때 MCP 도구가 자동으로 인식됩니다. 서버는 mcp.json 설정에 따라 자동으로 실행됩니다.

Claude for Desktop에 연결하기

  1. Claude for Desktop을 설치합니다.
  2. 터미널에서 서버를 실행합니다:
python server.py
  1. Claude for Desktop 설정에서 MCP 서버 섹션으로 이동하여 로컬 MCP 서버를 추가합니다.
  2. 서버 URL 또는 포트를 필요에 따라 구성합니다.
  3. 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 파일을 참조하세요.

참고문서

相关推荐

  • Joshua Armstrong
  • Confidential guide on numerology and astrology, based of GG33 Public information

  • https://suefel.com
  • Latest advice and best practices for custom GPT development.

  • Alexandru Strujac
  • Efficient thumbnail creator for YouTube videos

  • Emmet Halm
  • Converts Figma frames into front-end code for various mobile frameworks.

  • Elijah Ng Shi Yi
  • Advanced software engineer GPT that excels through nailing the basics.

  • Lists Tailwind CSS classes in monospaced font

  • https://maiplestudio.com
  • Find Exhibitors, Speakers and more

  • lumpenspace
  • Take an adjectivised noun, and create images making it progressively more adjective!

  • https://appia.in
  • Siri Shortcut Finder – your go-to place for discovering amazing Siri Shortcuts with ease

  • Carlos Ferrin
  • Encuentra películas y series en plataformas de streaming.

  • Yusuf Emre Yeşilyurt
  • I find academic articles and books for research and literature reviews.

  • tomoyoshi hirata
  • Sony α7IIIマニュアルアシスタント

  • apappascs
  • 发现市场上最全面,最新的MCP服务器集合。该存储库充当集中式枢纽,提供了广泛的开源和专有MCP服务器目录,并提供功能,文档链接和贡献者。

  • ShrimpingIt
  • MCP系列GPIO Expander的基于Micropython I2C的操作,源自ADAFRUIT_MCP230XX

  • jae-jae
  • MCP服务器使用剧作《无头浏览器》获取网页内容。

  • HiveNexus
  • 一个适用于中小型团队的AI聊天机器人,支持DeepSeek,Open AI,Claude和Gemini等车型。 专为中小团队设计的ai聊天应用,支持deepSeek,打开ai,claude,双子座等模型。

  • ravitemer
  • 一个功能强大的Neovim插件,用于管理MCP(模型上下文协议)服务器

  • patruff
  • Ollama和MCP服务器之间的桥梁,使本地LLMS可以使用模型上下文协议工具

    Reviews

    4 (1)
    Avatar
    user_PWtk4fVH
    2025-04-16

    I've been using hello-mcp-server-python by jongkwang, and it has significantly simplified my workflow. The server implementation is straightforward and well-documented, making it easy to set up and use. The welcoming message is a nice touch, and the support for Python ensures seamless integration with my existing projects. Highly recommended!