ds-rag-mcp

DS RAG MCP Server

MCP-сервер для поиска UI-компонентов с использованием RAG (Retrieval-Augmented Generation) на базе LanceDB и GigaChat. Сервер предоставляет инструменты для семантического поиска по документации UI-компонентов через Model Context Protocol.

Возможности

• Семантический поиск по документации UI-компонентов
• Генеративные ответы на базе найденного контекста
• Поддержка stdio и HTTP транспортов
• Локальное хранилище LanceDB (без Docker)
• Интеграция с GigaChat для эмбеддингов и генерации

Установка

Глобальная установка (рекомендуется)

npm install -g ds-rag-mcp

Или использование через npx

npx ds-rag-mcp

Для разработчиков

git clone <repository-url>
cd ds-rag-mcp
npm install
npm run build

Настройка

Для работы сервера необходимы следующие переменные окружения:

• GIGACHAT_API_KEY - API ключ или credentials для GigaChat (обязательно)
• GIGACHAT_MODEL - Модель GigaChat (по умолчанию: "GigaChat")
• GIGACHAT_SCOPE - Scope для авторизации (по умолчанию: "GIGACHAT_API_PERS")

Эти переменные передаются через конфигурацию MCP-клиента (см. ниже).

Векторная база данных

Пакет включает предзаполненную векторную базу данных LanceDB (.lancedb/) с документацией UI-компонентов. Дополнительная настройка не требуется.

Примечание для разработчиков: Если вы хотите пересоздать векторную базу из исходных markdown файлов, используйте команду npm run rag:recursive после клонирования репозитория.

Подключение к Claude Desktop

Через npx (рекомендуется)

Добавьте в конфигурацию Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "ds-rag-mcp": {
      "command": "npx",
      "args": ["-y", "ds-rag-mcp"],
      "env": {
        "GIGACHAT_API_KEY": "your-api-key-here",
        "GIGACHAT_MODEL": "GigaChat",
        "GIGACHAT_SCOPE": "GIGACHAT_API_PERS"
      }
    }
  }
}

Через глобальную установку

Если вы установили пакет глобально:

{
  "mcpServers": {
    "ds-rag-mcp": {
      "command": "ds-rag-mcp",
      "env": {
        "GIGACHAT_API_KEY": "your-api-key-here",
        "GIGACHAT_MODEL": "GigaChat",
        "GIGACHAT_SCOPE": "GIGACHAT_API_PERS"
      }
    }
  }
}

Важно: Замените your-api-key-here на ваш реальный API ключ GigaChat.

Тестирование с MCP Inspector

npm run mcp

В интерфейсе Inspector укажите:

• Command: npx
• Args: tsx, src/index.ts

Доступные инструменты

• componentSearch - Семантический поиск компонентов через RAG
• componentTest - Тестирование компонентов
• componentList - Получение списка доступных компонентов
• componentExamples - Примеры использования компонентов
• componentAPISearch - Поиск по API компонентов

Архитектура

• Stdio транспорт (src/index.ts) - основной entry point для MCP клиентов
• HTTP транспорт (src/server.ts) - Express сервер для HTTP подключений
• MCP Core (src/mcp-server.ts) - центральный объект с регистрацией инструментов
• RAG Pipeline (src/gigachat/RAG-tools/) - логика поиска и генерации ответов
• LanceDB (.lancedb/) - локальная векторная база данных

Разработка

Подробную документацию для разработчиков см. в CLAUDE.md

Лицензия

MIT