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
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:
- 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.
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This project is licensed under the MIT License - see the LICENSE file for details.