lightrag-mcp

MCP 服务器，将 LightRAG 连接到任何 MCP 客户端——Cursor、Claude Desktop 等。为代理提供持久化知识库访问：笔记、决策、文档、runbook。

两个工具，因为知识检索有两种不同的场景：

两个工具均标记为 readOnlyHint，因此客户端不会将其视为改变状态的操作。

安装

npm install

需要 Node.js 18 或更高版本——使用内置的 fetch。

Related MCP server: knowlib

配置

在 package.json 旁边创建 .env：

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