hello-mcp-server-python

jongkwang/hello-mcp-server-python

3.1
ai_chatbotcloud_platforms

If you are the rightful owner of hello-mcp-server-python and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

A Python server example project using the Model Context Protocol.

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 ํŒŒ์ผ์„ ์ฐธ์กฐํ•˜์„ธ์š”.

์ฐธ๊ณ ๋ฌธ์„œ

Related MCP Servers

View all ai_chatbot servers โ†’
biomcp

biomcp

4.6

by genomoncology

BioMCP is an open-source toolkit designed to enhance AI assistants with specialized biomedical knowledge by connecting them to authoritative biomedical data sources.

research_and_data
elevenlabs-mcp

elevenlabs-mcp

4.6

by elevenlabs

Official ElevenLabs Model Context Protocol (MCP) server for interaction with Text to Speech and audio processing APIs.

ai_chatbot
repomix

repomix

4.5

by yamadashy

Repomix is a tool that packs your codebase into AI-friendly formats, making it easier to use with AI tools like LLMs.

developer_tools
tavily-mcp

tavily-mcp

4.5

by tavily-ai

The Tavily MCP server is a Model Context Protocol server that integrates with AI systems to provide real-time web search and data extraction capabilities.

browser_automation
paelladoc

paelladoc

4.5

by jlcases

PAELLADOC is an AI-First Development framework implementing the Model Context Protocol (MCP) to enhance LLM interactions with external tools and context.

ai_chatbot
osp_marketing_tools

osp_marketing_tools

4.4

by open-strategy-partners

A comprehensive suite of tools for technical marketing content creation, optimization, and product positioning based on Open Strategy Partners' proven methodologies.

communication
mcp-server-calculator

mcp-server-calculator

4.4

by githejie

A Model Context Protocol server for calculating. This server enables LLMs to use calculator for precise numerical calculations.

developer_tools
Sequential Thinking

Sequential Thinking

4.3

by modelcontextprotocol

An MCP server implementation that provides a tool for dynamic and reflective problem-solving through a structured thinking process.

research_and_data
MiniMax-MCP

MiniMax-MCP

4.3

by MiniMax-AI

Official MiniMax Model Context Protocol (MCP) server for interaction with Text to Speech and video/image generation APIs.

ai_chatbot
mcp-server-reddit

mcp-server-reddit

4.1

by Hawstein

A Model Context Protocol server providing access to Reddit public API for LLMs.

ai_chatbot
exa-mcp-server

exa-mcp-server

3.8

by exa-labs

A Model Context Protocol (MCP) server allows AI assistants to use the Exa AI Search API for real-time web searches in a secure manner.

research_and_data
ableton-mcp

ableton-mcp

3.8

by ahujasid

AbletonMCP connects Ableton Live to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Ableton Live.

ai_chatbot
mcp-crawl4ai-rag

mcp-crawl4ai-rag

3.8

by coleam00

Crawl4AI RAG MCP Server is a powerful implementation of the Model Context Protocol (MCP) integrated with Crawl4AI and Supabase, providing AI agents and AI coding assistants with advanced web crawling and RAG capabilities.

browser_automation
modelcontextprotocol

modelcontextprotocol

3.8

by ppl-ai

The Perplexity Ask MCP Server integrates the Sonar API to provide Claude with real-time, web-wide research capabilities.

research_and_data
mcp-server-whisper

mcp-server-whisper

3.8

by arcaputo3

MCP Server Whisper is a Model Context Protocol server designed for advanced audio transcription and processing using OpenAI's Whisper and GPT-4o models.

ai_chatbot
tabby-mcp-server

tabby-mcp-server

3.8

by thuanpham582002

Tabby-MCP-Server is a powerful plugin that implements a Model Context Protocol (MCP) server, enabling AI-powered terminal control and automation.

ai_chatbot
Tianji

Tianji

3.7

by msgbyte

A server based on Model Context Protocol (MCP) that provides tools for interacting with the Tianji platform.

ai_chatbot
hyper-mcp

hyper-mcp

3.7

by tuananh

hyper-mcp is a fast, secure MCP server that extends its capabilities through WebAssembly plugins.

ai_chatbot
anyquery

anyquery

3.7

by julien040

Anyquery is a versatile SQL query engine that allows users to run SQL queries on various data sources, including files, databases, and applications, with support for LLMs and MySQL server functionality.

databases
minima

minima

3.7

by dmayboroda

Minima is an open-source RAG on-premises container solution that integrates with ChatGPT and MCP, allowing for fully local or hybrid installations.

ai_chatbot
UnityMCP

UnityMCP

3.7

by Arodoid

UnityMCP is a Unity Editor plugin that integrates the Model Context Protocol (MCP) for seamless interaction between Unity and AI assistants.

developer_tools
obsidian-mcp

obsidian-mcp

3.7

by StevenStavrakis

Obsidian MCP Server is a Model Context Protocol server that allows AI assistants to interact with Obsidian vaults, providing tools for managing notes and tags.

ai_chatbot
enrichmcp

enrichmcp

3.7

by featureform

MCPEngine is a production-grade, HTTP-first implementation of the Model Context Protocol (MCP), providing a secure, scalable, and modern framework for exposing data, tools, and prompts to Large Language Models (LLMs) via MCP.

developer_tools
mcp-youtube

mcp-youtube

3.7

by anaisbetts

The YouTube MCP Server utilizes `yt-dlp` to download subtitles from YouTube videos and connects to Claude.ai using the Model Context Protocol.

ai_chatbot
jinni

jinni

3.7

by smat-dev

Jinni is a tool designed to efficiently provide Large Language Models (LLMs) with the context of your projects by consolidating relevant project files.

developer_tools
actors-mcp-server

actors-mcp-server

3.7

by apify

Implementation of an MCP server for all Apify Actors, enabling interaction with one or more Apify Actors defined in the MCP Server configuration.

research_and_data
obsidian-mcp-tools

obsidian-mcp-tools

3.6

by jacksteamdev

MCP Tools for Obsidian enables AI applications like Claude Desktop to securely access and work with your Obsidian vault through the Model Context Protocol (MCP).

ai_chatbot