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        # Очистка кэша

Требования

• Python 3.12+
• uv 0.6+ (инструкция по установке)
• R2R instance (запущенный сервер)

Документация

Полная документация находится в CLAUDE.md