🚀 MCP 服务器研究项目
本项目聚焦于 MCP（消息协调协议）服务器的研究与演示，为分布式系统通信协调提供标准化解决方案，助力开发者高效实现相关功能。
🚀 快速开始
先决条件
- Python 3.8+
- Flask
- Requests
安装
# 克隆仓库
git clone https://github.com/ckz/mcp_server_research.git
cd mcp_server_research
# 设置虚拟环境
python -m venv venv
source venv/bin/activate # Windows系统请使用：venv\Scripts\activate
# 安装依赖项
pip install -r requirements.txt
运行示例
- 默认设置运行 MCP 服务器：
cd src/demo
python simple_mcp_server.py
访问 http://localhost:5001（或您指定的自定义端口）查看仪表盘。
- 自定义设置运行：
cd src/demo
DEBUG=true PORT=5001 python simple_mcp_server.py
- 运行客户端示例：在另一个终端中执行以下命令
cd src/demo
python client_demo.py --server http://localhost:5001 --duration 30 --interval 2
此时您应该会看到服务器接受连接，客户端成功发送消息。
✨ 主要特性
简单的 MCP 服务器演示实现了以下基本功能：
- 注册并跟踪已连接的客户端
- 处理各种消息类型（心跳、数据、命令）
- 将消息路由到适当的目的地
- 提供一个用于监控系统活动的 Web 仪表盘
- 维护内存中的消息历史记录
📦 安装指南
# 克隆仓库
git clone https://github.com/ckz/mcp_server_research.git
cd mcp_server_research
# 设置虚拟环境
python -m venv venv
source venv/bin/activate # Windows系统请使用：venv\Scripts\activate
# 安装依赖项
pip install -r requirements.txt
💻 使用示例
基础用法
以默认设置运行 MCP 服务器：
cd src/demo
python simple_mcp_server.py
访问 http://localhost:5001（或您指定的自定义端口）查看仪表盘。
高级用法
- 自定义设置运行：
cd src/demo
DEBUG=true PORT=5001 python simple_mcp_server.py
- 运行客户端示例：
cd src/demo
python client_demo.py --server http://localhost:5001 --duration 30 --interval 2
📚 详细文档
项目结构
mcp_server_research/
├── docs/ # 文档文件
├── src/ # 源代码
│ └── demo/ # 示例实现
└── requirements.txt
变更日志
2024 - 02 - 24
- 添加了客户端代码的错误处理以防止连接失败
- 使用会话在客户端中实现更好的连接管理
- 在服务器端添加 CORS 支持以处理跨域请求
- 实现 API 调用超时以防止长时间挂起
- 通过环境变量使调试模式可配置
- 解决依赖项问题，添加 flask - cors 并指定 werkzeug 版本
- 改进代码注释中的文档
📄 许可证
本项目采用 MIT 许可证。
贡献
欢迎贡献！请随意提交拉取请求。