mcp-server-examples

mcp-server-examples

3.5
python

This project includes examples of Model Context Protocol (MCP) servers, implementing functionalities like BMI calculation and weather information retrieval.

๐Ÿ ๐Ÿ“„

MCP Server Examples

์ด ํ”„๋กœ์ ํŠธ๋Š” Model Context Protocol (MCP) ์„œ๋ฒ„ ์˜ˆ์ œ๋“ค์„ ํฌํ•จํ•˜๊ณ  ์žˆ์Šต๋‹ˆ๋‹ค. BMI ๊ณ„์‚ฐ๊ณผ ๋‚ ์”จ ์ •๋ณด ์กฐํšŒ ๊ธฐ๋Šฅ์„ ์ œ๊ณตํ•˜๋Š” MCP ์„œ๋ฒ„๋ฅผ ๊ตฌํ˜„ํ•ฉ๋‹ˆ๋‹ค.

ํ”„๋กœ์ ํŠธ ๊ตฌ์กฐ

mcp-server-examples/
โ”œโ”€โ”€ .venv/              # Python ๊ฐ€์ƒํ™˜๊ฒฝ
โ”œโ”€โ”€ server.py           # MCP ์„œ๋ฒ„ ๊ตฌํ˜„ (BMI ๊ณ„์‚ฐ๊ธฐ, ๋‚ ์”จ ์ •๋ณด ์กฐํšŒ)
โ””โ”€โ”€ config.json         # ์„œ๋ฒ„ ์„ค์ • ํŒŒ์ผ

์ œ๊ณตํ•˜๋Š” ๋„๊ตฌ๋“ค

  1. BMI ๊ณ„์‚ฐ๊ธฐ

    • ํ‚ค(m)์™€ ๋ชธ๋ฌด๊ฒŒ(kg)๋ฅผ ์ž…๋ ฅ๋ฐ›์•„ BMI ์ง€์ˆ˜๋ฅผ ๊ณ„์‚ฐ
    • calculate_bmi ๋„๊ตฌ ์‚ฌ์šฉ

  2. ๋‚ ์”จ ์ •๋ณด ์กฐํšŒ

    • ๋„์‹œ ์ด๋ฆ„์„ ์ž…๋ ฅ๋ฐ›์•„ ํ•ด๋‹น ๋„์‹œ์˜ ๋‚ ์”จ ์ •๋ณด๋ฅผ ์กฐํšŒ
    • fetch_weather ๋„๊ตฌ ์‚ฌ์šฉ

ํ”„๋กœ์ ํŠธ ์„ค์ • ๋ฐ ์‹คํ–‰ ๋ฐฉ๋ฒ•

1. Python ๊ฐ€์ƒํ™˜๊ฒฝ ์ƒ์„ฑ

# venv ๋ชจ๋“ˆ์„ ์‚ฌ์šฉํ•˜์—ฌ ๊ฐ€์ƒํ™˜๊ฒฝ ์ƒ์„ฑ
python -m venv .venv

# ๊ฐ€์ƒํ™˜๊ฒฝ ํ™œ์„ฑํ™”
# Windows์˜ ๊ฒฝ์šฐ:
.venv\Scripts\activate
# macOS/Linux์˜ ๊ฒฝ์šฐ:
source .venv/bin/activate

2. ํ•„์š”ํ•œ ํŒจํ‚ค์ง€ ์„ค์น˜

# MCP ํŒจํ‚ค์ง€ ์„ค์น˜ (CLI ๋„๊ตฌ ํฌํ•จ)
pip install "mcp[cli]"

# HTTP ํด๋ผ์ด์–ธํŠธ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ ์„ค์น˜ (๋‚ ์”จ API ํ˜ธ์ถœ์šฉ)
pip install httpx

3. ์„œ๋ฒ„ ์‹คํ–‰

๊ฐœ๋ฐœ ๋ชจ๋“œ๋กœ ์„œ๋ฒ„๋ฅผ ์‹คํ–‰ํ•˜๊ฑฐ๋‚˜ Claude Desktop์— ์„ค์น˜ํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค:

# ๊ฐœ๋ฐœ ๋ชจ๋“œ๋กœ ์„œ๋ฒ„ ์‹คํ–‰
mcp dev server.py

# Claude Desktop์— ์„œ๋ฒ„ ์„ค์น˜
mcp install server.py

์˜์กด์„ฑ ํŒจํ‚ค์ง€

  • mcp: Model Context Protocol ๊ตฌํ˜„์„ ์œ„ํ•œ ํ•ต์‹ฌ ํŒจํ‚ค์ง€
  • httpx: ๋น„๋™๊ธฐ HTTP ํด๋ผ์ด์–ธํŠธ ๋ผ์ด๋ธŒ๋Ÿฌ๋ฆฌ (๋‚ ์”จ API ํ˜ธ์ถœ์šฉ)

์„œ๋ฒ„ ์‚ฌ์šฉ ๋ฐฉ๋ฒ•

์„œ๋ฒ„๊ฐ€ ์‹คํ–‰๋˜๋ฉด Claude Desktop์—์„œ ๋‹ค์Œ๊ณผ ๊ฐ™์€ ๋„๊ตฌ๋“ค์„ ์‚ฌ์šฉํ•  ์ˆ˜ ์žˆ์Šต๋‹ˆ๋‹ค:

  1. BMI ๊ณ„์‚ฐํ•˜๊ธฐ:

    • ํ‚ค(๋ฏธํ„ฐ)์™€ ๋ชธ๋ฌด๊ฒŒ(ํ‚ฌ๋กœ๊ทธ๋žจ)๋ฅผ ์ž…๋ ฅํ•˜๋ฉด BMI ์ง€์ˆ˜๋ฅผ ๊ณ„์‚ฐํ•ด์ค๋‹ˆ๋‹ค
    • ์˜ˆ: ํ‚ค 1.79m, ๋ชธ๋ฌด๊ฒŒ 80kg โ†’ BMI 25.0

  2. ๋‚ ์”จ ์ •๋ณด ์กฐํšŒํ•˜๊ธฐ:

    • ๋„์‹œ ์ด๋ฆ„์„ ์ž…๋ ฅํ•˜๋ฉด ํ•ด๋‹น ๋„์‹œ์˜ ํ˜„์žฌ ๋‚ ์”จ ์ •๋ณด๋ฅผ ์กฐํšŒํ•ฉ๋‹ˆ๋‹ค
    • API๋ฅผ ํ†ตํ•ด ์‹ค์‹œ๊ฐ„ ๋‚ ์”จ ๋ฐ์ดํ„ฐ๋ฅผ ์ œ๊ณตํ•ฉ๋‹ˆ๋‹ค

Related MCP Servers

View all python servers โ†’
mcp-server-template

mcp-server-template

3.6

by narumiruna

The MCP Server Template is a foundational framework designed to facilitate the development and deployment of model context protocol servers, leveraging LLM and MCP technologies.

python
MCP-Github-Oauth

MCP-Github-Oauth

3.6

by Nikhil-Patil-RI

This document provides a guide to setting up a Model Context Protocol (MCP) server environment, specifically for integrating with the Claude desktop app and debugging using the MCP Inspector.

python
benchmark-proxy-mcp

benchmark-proxy-mcp

3.4

by zengzhuozhen

The benchmark-proxy is an MCP server designed to facilitate the benchmarking of model context protocols, providing a robust environment for testing and evaluation.

python
mcp-server-demo

mcp-server-demo

3.4

by qitongfire

This is a Python-based MCP server demonstration project.

python
template-mcp-server

template-mcp-server

3.4

by pdm-project

An example MCP server developed by Python and PDM.

python
binoculo-mcp

binoculo-mcp

3.4

by girorme

BinoculoMCP is a Message Control Protocol (MCP) Server designed to interact with the Binoculo tool for banner-grabbing operations.

bugbounty
mcp-testing

mcp-testing

3.4

by marhoy

This document provides an overview and usage instructions for a Model Context Protocol (MCP) server, which facilitates communication between models and clients using the MCP technology.

python
bilibili-api-mcp-server

bilibili-api-mcp-server

3.4

by njhzqj

A Model Context Protocol (MCP) server designed to interface with the Bilibili API, allowing for seamless integration and interaction with Bilibili's platform.

python
gCalendar-mcp-python

gCalendar-mcp-python

3.4

by tobedoit

MCP Calendar is a tool for creating Google Calendar events using the Model Context Protocol server.

python