mcp_server_research

🚀 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 许可证。

贡献

欢迎贡献！请随意提交拉取请求。