MCP Server Demo

This project demonstrates the implementation of a Model Context Protocol (MCP) server. MCP is a protocol designed to facilitate communication between AI models and external tools/services while maintaining context awareness.

Features

Basic MCP server implementation
Example tool integrations
Context management demonstration
WebSocket-based real-time communication
Simple client example

Related MCP server: MCP Toolkit

Project Structure

mcp-server-demo/ ├── src/ │ ├── server.py # Main MCP server implementation │ ├── tools/ # Tool implementations │ │ ├── __init__.py │ │ └── basic_tools.py │ ├── context/ # Context management │ │ ├── __init__.py │ │ └── manager.py │ └── utils/ # Utility functions │ ├── __init__.py │ └── helpers.py ├── examples/ # Example usage │ ├── client.py │ └── tools_demo.py ├── tests/ # Test cases │ └── test_server.py ├── requirements.txt # Project dependencies └── README.md # This file

Installation

Clone the repository:

git clone https://github.com/tian1ll1/mcp-server-demo.git cd mcp-server-demo

Create a virtual environment (recommended):

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

Install dependencies:

pip install -r requirements.txt

Usage

Start the MCP server:

python src/server.py

Run the example client:

python examples/client.py

How It Works

The MCP server implements the following key components:

Context Management: Maintains conversation history and relevant context for each session.
Tool Registry: Manages available tools and their specifications.
Message Processing: Handles incoming messages and routes them to appropriate tools.
WebSocket Server: Provides real-time communication with clients.