lightrag-mcp

LightRAGを任意のMCPクライアント（Cursor、Claude Desktopなど）に接続するMCPサーバーです。エージェントに永続的なナレッジベース（メモ、決定事項、ドキュメント、ランブック）へのアクセスを提供します。

知識の抽出には2つの異なるシナリオがあるため、2つのツールがあります：

両方のツールはreadOnlyHintとしてマークされているため、クライアントはこれらを状態を変更するものとして認識しません。

インストール

npm install

Node.js 18以上が必要です。組み込みのfetchを使用します。

Related MCP server: expert-mcp-server

設定

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