MCP Server Demo

MCP Server Demo

A demonstration project for building MCP (Model Context Protocol) servers using the Python MCP SDK.

What is MCP?

The Model Context Protocol (MCP) allows applications to provide context for LLMs in a standardized way. This project demonstrates how to:

• Build MCP servers that expose resources, tools, and prompts
• Use the FastMCP framework for rapid development
• Run servers in development mode with hot reloading

Features

This demo server includes:

• Calculator Tools: Basic arithmetic operations
• Greeting Resources: Dynamic personalized greetings
• Code Review Prompts: Reusable templates for code review
• Development Mode: Hot reloading and debugging support

Installation

1. Create and activate a virtual environment:

2. Install dependencies:

Quick Start

Development Mode (Recommended)

Run the server in development mode with hot reloading:

This will start the MCP Inspector where you can test your server interactively.

Direct Execution

Run the server directly:

Claude Desktop Integration

Install the server in Claude Desktop:

Project Structure

API Reference

Tools

• add(a: int, b: int) -> int: Add two numbers
• multiply(a: int, b: int) -> int: Multiply two numbers
• calculate_bmi(weight_kg: float, height_m: float) -> float: Calculate BMI

Resources

• greeting://{name}: Get a personalized greeting for a given name
• config://app: Get application configuration

Prompts

• review_code: Template for code review requests
• debug_error: Template for debugging error messages

Development

The server uses FastMCP which provides:

• Automatic type validation
• Built-in error handling
• Development mode with hot reloading
• Easy integration with Claude Desktop

Learn More

• MCP Python SDK Documentation
• Model Context Protocol Specification
• FastMCP Examples