lightrag-mcp

Servidor MCP que conecta LightRAG a cualquier cliente MCP — Cursor, Claude Desktop y otros. Da al agente acceso a una base de conocimientos persistente: notas, decisiones, documentación, runbooks.

Dos herramientas, porque la extracción de conocimiento tiene dos escenarios diferentes:

Ambas herramientas están marcadas como readOnlyHint, por lo que el cliente no las percibirá como modificadoras de estado.

Instalación

npm install

Se requiere Node.js 18 o superior: se utiliza el fetch integrado.

Related MCP server: expert-mcp-server

Configuración

Cree un archivo .env junto a package.json:

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

LIGHTRAG_URL es opcional y por defecto es http://localhost:9621. LIGHTRAG_API_KEY es obligatorio: sin él, el servidor falla al inicio con un error claro, no en el momento de la primera solicitud.

La ruta al archivo de entorno se puede sobrescribir con la variable LIGHTRAG_MCP_ENV_FILE — útil cuando el cliente inicia el servidor desde otro directorio de trabajo.

Conexión a Cursor

En ~/.cursor/mcp.json:

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

Modos de búsqueda

El parámetro mode acepta mix (por defecto), hybrid, local, global y naive. Un modo desconocido se rechaza antes de la solicitud de red. Las solicitudes siempre se envían con enlaces a fuentes habilitados y reranking.

Pruebas

npm test

Las pruebas utilizan el node --test integrado, sin dependencias externas. HTTP se sustituye mediante el parámetro fetchImpl, por lo que se verifican tanto respuestas exitosas como errores: clave faltante, pregunta vacía, modo desconocido, estado de respuesta no exitoso.

Licencia

MIT