MCP Server Research

🚀 MCP Server Research Project

This project encompasses research and demonstrations related to the implementation of the MCP (Message Coordination Protocol) server, offering a standardized approach for communication and coordinated actions in distributed systems.

🚀 Quick Start

Prerequisites

• Python 3.8+
• Flask
• Requests

📦 Installation

# Clone the repository
git clone https://github.com/ckz/mcp_server_research.git
cd mcp_server_research

# Set up a virtual environment
python -m venv venv
source venv/bin/activate  # For Windows, use: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

💻 Usage Examples

Basic Usage

Run the MCP server with default settings:

cd src/demo
python simple_mcp_server.py

Then access http://localhost:5001 (or your custom - specified port) to view the dashboard.

Advanced Usage

Run with custom settings via environment variables:

cd src/demo
DEBUG=true PORT=5001 python simple_mcp_server.py

Run the client example in another terminal:

cd src/demo
python client_demo.py --server http://localhost:5001 --duration 30 --interval 2

You should see the server accept the connection and the client successfully send messages.

✨ Features

The simple MCP server demonstration implements the following basic functions:

• Register and track connected clients.
• Handle various message types (heartbeat, data, commands).
• Route messages to appropriate destinations.
• Provide a web dashboard for monitoring system activities.
• Maintain an in - memory message history.

📚 Documentation

Project Structure

mcp_server_research/
├── docs/          # Documentation files
├── src/           # Source code
│   └── demo/      # Example implementation
└── requirements.txt

Changelog

2024 - 02 - 24

• Added error handling in client code to prevent connection failures.
• Implemented better connection management in the client using sessions.
• Added CORS support on the server side to handle cross - domain requests.
• Implemented API call timeouts to prevent long - term hangs.
• Made the debug mode configurable via environment variables.
• Resolved dependency issues, added flask - cors and specified the werkzeug version.
• Improved documentation in code comments.

📄 License

MIT

Contribution

Contributions are welcome! Feel free to submit pull requests.