How do I use R2R FastMCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@R2R FastMCP Server search for recent updates on our project documentation" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

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