MCP Server Research Project

MCP 服务研究项目

该项目包含与 MCP（消息协调协议）服务实现相关的研究和演示。

概述

消息协调协议（MCP）为分布式系统提供了一种标准化的通信和协调操作方式。此代码库包含该协议的参考实现及其运行演示。

项目结构

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

开始使用

前提条件

• Python 3.8+
• Flask
• Requests

安装

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

# Set up virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

运行演示

使用默认设置运行 MCP 服务：

cd src/demo
python simple_mcp_server.py

使用环境变量自定义设置运行：

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

然后访问 http://localhost:5001（或你指定的自定义端口）查看仪表板。

在单独的终端中运行客户端演示：

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

你应该会看到服务接受连接，且客户端成功发送消息。

演示功能

这个简单的 MCP 服务演示实现了一个基本的消息协调协议服务，能够：

• 注册并跟踪已连接的客户端
• 处理各种消息类型（心跳、数据、命令）
• 将消息路由到相应的目标
• 提供用于监控系统活动的 Web 仪表板
• 在内存中维护消息历史记录

许可证

MIT

参与贡献

欢迎贡献！请随时提交 Pull Request。

更新日志

2024-02-24

• 为客户端代码添加了完善的错误处理，以应对连接失败
• 在客户端中使用会话，以便更好地管理连接
• 为服务添加了 CORS 支持，以处理跨域请求
• 为 API 调用实现了超时机制，防止调用挂起
• 使调试模式可通过环境变量配置
• 添加 flask-cors 并指定 werkzeug 版本，修复依赖问题
• 改进了代码注释中的文档说明