lightrag-mcp

MCP-сервер, который подключает LightRAG к любому MCP-клиенту — Cursor, Claude Desktop и другим. Даёт агенту доступ к постоянной базе знаний: заметкам, решениям, документации, ранбукам.

Два инструмента, потому что у извлечения знаний два разных сценария:

Инструмент	Что делает	Когда нужен
search_lightrag	Возвращает готовый ответ со ссылками на источники	Обычный вопрос к базе знаний
get_lightrag_context	Возвращает только контекст и источники, без генерации ответа	Когда ответ нужно собрать самому: сверить с кодом, совместить с текущим диалогом

Оба инструмента помечены как readOnlyHint, поэтому клиент не будет воспринимать их как изменяющие состояние.

Установка

npm install

Требуется Node.js 18 или новее — используется встроенный fetch.

Настройка

Создайте .env рядом с package.json:

LIGHTRAG_URL=http://localhost:9621
LIGHTRAG_API_KEY=ваш-ключ

LIGHTRAG_URL необязателен и по умолчанию равен http://localhost:9621. LIGHTRAG_API_KEY обязателен: без него сервер падает на старте с внятной ошибкой, а не в момент первого запроса.

Путь к файлу окружения можно переопределить переменной LIGHTRAG_MCP_ENV_FILE — удобно, когда клиент запускает сервер из другого рабочего каталога.

Подключение к Cursor

В ~/.cursor/mcp.json:

{
  "mcpServers": {
    "lightrag": {
      "command": "node",
      "args": ["/абсолютный/путь/lightrag-mcp/src/server.js"],
      "env": {
        "LIGHTRAG_MCP_ENV_FILE": "/абсолютный/путь/lightrag-mcp/.env"
      }
    }
  }
}

Режимы поиска

Параметр mode принимает mix (по умолчанию), hybrid, local, global и naive. Неизвестный режим отклоняется до сетевого запроса. Запросы всегда уходят с включёнными ссылками на источники и реранкингом.

Тесты

npm test

Тесты используют встроенный node --test, без внешних зависимостей. HTTP подменяется через параметр fetchImpl, поэтому проверяются и успешные ответы, и ошибки: отсутствующий ключ, пустой вопрос, неизвестный режим, неуспешный статус ответа.

Лицензия

MIT