간단한 모델 Context Protocol (MCP) 서버는 3개의 유틸리티 도구를 갖춘 FastMCP로 구축되었습니다.

도구

1. generate uuid - 랜덤 UUID 생성 (버전 4 또는 1)
2. convert temperature - 섭씨와 화씨 사이 온도 변환
3. text statistics - 기본 텍스트 통계 (문자, 단어, 줄)

설치

uv를 사용하여 의존성을 설치하십시오:

사용법

서버 실행

MCP 서버를 HTTP 수송으로 시작하십시오:

서버는 기본적으로 http://localhost:8000/mcp에서 시작합니다.

FastMCP 클라이언트 테스트

FastMCP 기반 클라이언트를 실행:

httpx 클라이언트와 테스트

순수한 httpx 클라이언트를 실행 (MCP 라이브러리 필요):

컬 클라이언트와 테스트

컬과 jq를 사용하여 bash 스크립트를 실행:

** 컬 클라이언트에 대한 요구 사항 : **

• curl (HTTP 요청)
• jq ( JSON 파싱용)
• 표준 유닉스 도구 ([T3]], sed, awk, tr)

프로젝트 구조

• server.py - 3개의 유틸리티 도구로 MCP 서버
• client_fastmcp.py - FastMCP 라이브러리를 사용하여 클라이언트
• client_httpx.py - 직접 HTTP 요청을 위해 HTTPx만 사용하는 클라이언트
• client_curl.sh - 컬과 jq를 사용하여 Bash 스크립트 클라이언트
• `메인.

Simple MCP Server

A simple Model Context Protocol (MCP) server built with FastMCP, featuring three utility tools.

Tools

1. generate_uuid - Generates a random UUID (version 4 or 1)
2. convert_temperature - Converts temperature between Celsius and Fahrenheit
3. text_statistics - Calculates basic text statistics (characters, words, lines)

Installation

Install dependencies using uv:

uv sync

Usage

Running the Server

Start the MCP server with HTTP transport:

uv run server.py

The server will start on http://localhost:8000/mcp by default.

Testing with FastMCP Client

Run the FastMCP-based client:

uv run client_fastmcp.py

Testing with httpx Client

Run the pure httpx client (no MCP libraries required):

uv run client_httpx.py

Testing with curl Client

Run the bash script using only curl and jq:

./client_curl.sh

Requirements for curl client:

• curl (for HTTP requests)
• jq (for JSON parsing)
• Standard Unix tools (grep, sed, awk, tr)

Project Structure

• server.py - MCP server with three utility tools
• client_fastmcp.py - Client using FastMCP library
• client_httpx.py - Client using only httpx for direct HTTP requests
• client_curl.sh - Bash script client using curl and jq
• main.py - Original template file (not used)

Example Output

All three clients will:

1. Connect to the server
2. List available tools
3. Test generate_uuid (generates a UUID v4)
4. Test convert_temperature (converts 0°C to Fahrenheit → 32.0°F)
5. Test text_statistics (counts characters, words, and lines in sample text)

Example:

Test 1: Generate UUID
Result: 98f99e94-7357-4dd4-85eb-76819fad3ada

Test 2: Convert temperature (0°C to Fahrenheit)
Result: 32.0

Test 3: Text statistics
Result: {"characters":47,"words":9,"lines":3}

Technical Details

• Transport: Streamable HTTP (MCP protocol over HTTP)
• Endpoint: /mcp
• Response Format: Server-Sent Events (SSE)
• Session Management: Server assigns session ID via Mcp-Session-Id header

Client Implementations

1. FastMCP Client (client_fastmcp.py):

   • Uses official MCP Python SDK
   • Handles SSE automatically
   • Full protocol support

2. httpx Client (client_httpx.py):

   • Pure Python with only httpx dependency
   • Manual JSON-RPC implementation
   • Custom SSE parsing

3. curl Client (client_curl.sh):

   • Bash script using curl and jq
   • Demonstrates raw HTTP requests
   • No Python dependencies required

Requirements

• Python 3.13+
• fastmcp
• httpx (included as fastmcp dependency)