R2R FastMCP Server

R2R FastMCP服务器

用于将R2R（Retrieval Augmented Generation）与Claude Desktop集成的MCP服务器。

可用实现：

• server.py -带有5个专用工具（搜索、RAG、高级搜索、图形搜索、高级RAG）的定制MCP服务器
• r2r_openapi_server.py 从OpenAPI R2R规范自动生成（完全访问所有R2R API端点）

快速启动

# Установка зависимостей через uv
make install

# Настройка окружения
cp .env.example .env
# Отредактируй .env с твоими настройками

# Проверка кода
make lint

# Запуск сервера
make run

备注： 项目使用 uv 来管理依赖关系。确保UV安装： curl -LsSf https://astral.sh/uv/install.sh | sh

安装Claude Desktop

定制服务器（5个工具）：

# Если возникает ошибка с typer, сначала обнови зависимости:
# pip install --upgrade 'mcp[cli]'

mcp install server.py -v R2R_BASE_URL=http://localhost:7272

OpenAPI服务器（完整的R2R API）：

# Локальная разработка (stdio)
python r2r_openapi_server.py

# Production деплой (HTTP)
uvicorn r2r_openapi_server:app --host 0.0.0.0 --port 8000

# Claude Desktop установка
mcp install r2r_openapi_server.py -v R2R_BASE_URL=http://localhost:7272

可用工具

• search 搜索R2R知识库（Vector，Graph，Web，Document）
• rag -生成响应的RAG请求

GUI测试

使用工具进行视觉测试 MCP检查员:

# Запуск Inspector с веб-интерфейсом
make run-inspector

浏览器将打开 http://localhost:5173 使用GUI：

• 查看R2R API中的所有114个工具
• 使用参数调用工具
• 实时查看结果和日志

开发团队

# Установка и управление
make help         # Список всех команд
make install      # Установка зависимостей

# Проверка кода
make lint         # Проверка кода (format + typecheck)
make fix          # Автоматическое исправление

# Запуск серверов
make run          # Запуск custom MCP server (server.py)
make run-openapi  # Запуск OpenAPI MCP server (stdio режим)
make run-http     # Запуск OpenAPI MCP server (HTTP режим на :8000)
make run-gemini   # Запуск Gemini интеграции (интерактивный)
make run-inspector # Запуск MCP Inspector (GUI для тестирования)

# Утилиты
make clean        # Очистка кэша

要求

• Python 3.12+
• 紫外线0.6+(安装说明)
• R2R Instance（正在运行的服务器）

文件

完整的文件在 CLAUDE.md