Model Context Protocol (MCP) Server

A basic implementation of a Model Context Protocol server for educational purposes. This server demonstrates the core concepts of MCP and how to implement them in practice using Python.

Features

• WebSocket-based communication using FastAPI and WebSockets

• Basic MCP message handling with Pydantic models

• Support for model context management

• Simple client-server interaction

• Async/await support for better performance

Related MCP server: MCP Server Sample

Getting Started

1. Create a virtual environment (recommended):

python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

2. Install dependencies:

pip install -r requirements.txt

3. Start the development server:

python -m src.server

4. Run the example client:

python examples/basic_usage.py

Project Structure

src/
├── server.py          # Main server implementation
├── types/            # TypeScript type definitions
│   └── mcp.py        # MCP protocol types using Pydantic
└── examples/         # Example implementations
    └── basic_usage.py # Basic client example

MCP Protocol Overview

The Model Context Protocol (MCP) is a communication protocol designed for AI model interactions. This implementation includes:

• Message format handling using Pydantic models

• Context management

• Basic protocol operations

• Async/await support for better performance

Key Differences from TypeScript Version

1. Uses FastAPI instead of Express

2. Implements async/await for better performance

3. Uses Pydantic for data validation and serialization

4. More Pythonic code structure and patterns MIT