LlamaCloud MCP Server

注意

このプロジェクトはアーカイブ済みで、サポートは終了しています。エージェントとLlamaParse Platform APIの接続に関する最新情報については、ドキュメントをご覧ください。

LlamaCloud MCP Server

LlamaCloud上の複数のマネージドインデックスに接続するMCPサーバーです。

これはTypeScriptベースのMCPサーバーで、LlamaCloud上の特定のマネージドインデックスにそれぞれ接続された複数のツールを作成します。各ツールはコマンドライン引数で定義します。

機能

ツール

• 定義したインデックスごとに個別のツールを作成します
• 各ツールには、対象のインデックスを検索するためのqueryパラメーターが用意されています
• インデックス名に基づいて、get_information_index_nameのようなツール名を自動生成します

インストール

MCPクライアント（Claude Desktop、Windsurf、Cursorなど）で使用するには、以下の設定をMCPクライアントの設定に追加してください。

LLAMA_CLOUD_PROJECT_NAME環境変数は省略可能で、設定されていない場合はDefaultが既定値になります。

{
  "mcpServers": {
    "llamacloud": {
      "command": "npx",
      "args": [
        "-y",
        "@llamaindex/mcp-server-llamacloud",
        "--index",
        "10k-SEC-Tesla",
        "--description",
        "10k SEC documents from 2023 for Tesla",
        "--topK",
        "5",
        "--index",
        "10k-SEC-Apple",
        "--description",
        "10k SEC documents from 2023 for Apple"
      ],
      "env": {
        "LLAMA_CLOUD_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Claudeでは、MCPの設定ファイルは次の場所にあります。

• MacOSの場合：~/Library/Application Support/Claude/claude_desktop_config.json
• Windowsの場合：%APPDATA%/Claude/claude_desktop_config.json

ツール定義の形式

MCP設定のargs配列では、--indexと--descriptionの引数をペアで指定することで、複数のツールを定義できます。各ペアで新しいツールが定義されます。また、必要に応じて--topKを指定し、結果の数を制限することもできます。

例：

--index "10k-SEC-Tesla" --description "10k SEC documents from 2023 for Tesla" --topK 5

LlamaCloudの10k-SEC-Teslaインデックス用のツールをMCPサーバーに追加します。この例では、上位5件の結果を返すように設定されています。

開発

依存関係をインストールします。

npm install

サーバーをビルドします。

npm run build

自動再ビルドを有効にして開発する場合：

npm run watch

開発版を使用するには、MCP設定でnpx @llamaindex/mcp-server-llamacloudをnode ./build/index.jsに置き換えてください。

デバッグ

MCPサーバーはstdio経由で通信するため、デバッグが難しい場合があります。パッケージスクリプトから利用できるMCP Inspectorの使用をおすすめします。

npm run inspector

Inspectorから、ブラウザーでデバッグツールにアクセスするためのURLが提供されます。