MCP 服务器研究项目

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

概述

消息协调协议（MCP）为分布式系统之间的通信和协调行动提供了一种标准化方式。此仓库包括该协议的参考实现以及其实例展示。

项目结构

mcp_server_research/
├── docs/          # 文档文件
├── src/           # 源代码
│   └── demo/      # 示例实现
└── requirements.txt

入门指南

先决条件

• 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

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

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

贡献

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

变更日志

2024-02-24

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