R2R FastMCP Server

MCP-сервер для интеграции R2R (Retrieval-Augmented Generation) с Claude Desktop.

Доступные реализации:

server.py — Кастомный MCP сервер с 5 специализированными инструментами (search, rag, advanced_search, graph_search, advanced_rag)
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:

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

Откроется браузер на http://localhost:5173 с GUI для:

Просмотра всех 114 инструментов из R2R API
Вызова инструментов с параметрами
Просмотра результатов и логов в реальном времени

Команды разработки

# Установка и управление 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 # Очистка кэша