lightrag-mcp

MCP 서버로, LightRAG를 Cursor, Claude Desktop 등 모든 MCP 클라이언트에 연결합니다. 에이전트에게 노트, 결정 사항, 문서, 런북 등 영구 지식 베이스에 대한 접근 권한을 제공합니다.

지식 검색에는 두 가지 시나리오가 있으므로 도구도 두 가지입니다:

두 도구 모두 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