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 許可證。

貢獻

歡迎貢獻！請隨意提交拉取請求。