R2r MCP

🚀 R2R MCP 服務器

R2R MCP 服務器是一款功能強大的工具，可與大語言模型（LLM）進行交互。它藉助 MCP 協議集成多種模型，並提供豐富的功能模塊，極大提升了與 LLM 交互的效率和體驗。

🚀 快速開始

R2R MCP 服務器是一個強大的工具，用於與各種大語言模型（LLM）進行交互。以下是使用該服務器的快速指南：

from r2r_mcp_server import MCPClient

client = MCPClient("http://localhost:8000")
response = client.chat_completion(
    messages=[{"role": "user", "content": "你好，我是測試用戶。"}]
)
print(response)

✨ 主要特性

模型交互

• 支持通過 MCP 協議與各種 LLM 進行對話。
• 提供上下文管理功能，可保持對話歷史，使對話更連貫。
• 支持文件附件上傳和下載，方便數據交互。

功能模塊

• 文檔解析：支持對 PDF、Word 等格式文檔進行自動解析。
• 代碼解釋：能夠理解並解釋多種編程語言代碼。
• 數據處理：支持對 CSV、JSON 等數據格式進行處理與分析。
• 圖像識別：集成 OCR 技術，可識別圖像內容。

性能優化

• 支持異步請求處理，提升系統響應速度。
• 提供結果緩存機制，減少重複計算。
• 經過嚴格的性能測試，保證系統穩定性。

📦 安裝指南

安裝依賴

pip install mcp r2r loguru pytest pytest-asyncio pytest-cov black isort mypy ruff httpx

初始化項目

mcp init --name "R2R MCP Server" --description "A powerful LLM interaction server"

📚 詳細文檔

配置說明

環境變量

• R2R_API_KEY：R2R 服務的訪問密鑰。
• MCP_SERVER_ADDRESS：MCP 服務器地址。
• LOG_LEVEL：日誌級別（DEBUG, INFO, WARNING, ERROR）。

日誌配置

import logging

logging.basicConfig(
    level=logging.INFO,
    format='%(asctime)s - %(name)s - %(levelname)s - %(message)s'
)

開發指南

功能擴展

1. 新增模型支持：實現 ModelAdapter 接口，針對具體模型進行適配。
2. 擴展功能模塊：在 extensions 目錄下添加新的功能插件。
3. 定製命令行工具：通過 cli.py 實現自定義命令。

貢獻指南

1. Fork 倉庫。
2. 創建功能分支：git checkout -b feature/amazing-feature。
3. 提交代碼併合併到主分支。

性能優化

• 使用異步處理提升系統響應速度。
• 集成緩存機制減少重複計算。
• 定期清理無效上下文以釋放資源。

集成其他 MCP 兼容模型

R2R MCP Server 支持與多種 MCP 兼容模型集成，包括：

• Claude（通過 Claude.app 或 API）。
• 其他 LLM 模型。
• 自定義 MCP 客戶端。

依賴管理

項目結構

r2r-mcp-server/
├── server.py          # 主服務程序
├── extensions/       # 功能擴展模塊
│   ├── document_parsing.py    # 文檔解析模塊
│   └── code_interpreter.py     # 代碼解釋器模塊
├── cli.py            # 命令行工具
└── tests/           # 測試用例
    └── test_server.py      # 服務測試用例

💻 使用示例

基礎用法

from r2r_mcp_server import MCPClient

client = MCPClient("http://localhost:8000")
response = client.chat_completion(
    messages=[{"role": "user", "content": "你好，我是測試用戶。"}]
)
print(response)

📄 許可證

本項目採用 MIT License。

項目維護者

• 張三（peter.zhang@example.com）
• 李四（jack lee@example.com）