mcp-server-llamacloud

# LlamaCloud MCP Server A MCP server connecting to multiple managed indexes on [LlamaCloud](https://cloud.llamaindex.ai/) This is a TypeScript-based MCP server that creates multiple tools, each connected to a specific managed index on LlamaCloud. Each tool is defined through command-line arguments. <a href="https://glama.ai/mcp/servers/o4fcj7x2cg"><img width="380" height="200" src="https://glama.ai/mcp/servers/o4fcj7x2cg/badge" alt="LlamaCloud Server MCP server" /></a> ## Features ### Tools - Creates a separate tool for each index you define - Each tool provides a `query` parameter to search its specific index - Auto-generates tool names like `get_information_index_name` based on index names ## Installation To use with your MCP Client (e.g. Claude Desktop, Windsurf or Cursor), add the following config to your MCP client config: The `LLAMA_CLOUD_PROJECT_NAME` environment variable is optional and defaults to `Default` if not set. ```json { "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>" } } } } ``` For Claude, the MCP config can be found at: - On MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json` - On Windows: `%APPDATA%/Claude/claude_desktop_config.json` ### Tool Definition Format In the `args` array of the MCP config, you can define multiple tools by providing pairs of `--index` and `--description` arguments. Each pair defines a new tool. You can also optionally specify `--topK` to limit the number of results. For example: ```bash --index "10k-SEC-Tesla" --description "10k SEC documents from 2023 for Tesla" --topK 5 ``` Adds a tool for the `10k-SEC-Tesla` LlamaCloud index to the MCP server. In this example, it's configured to return the top 5 results. ## Development Install dependencies: ```bash npm install ``` Build the server: ```bash npm run build ``` For development with auto-rebuild: ```bash npm run watch ``` To use the development version, replace in your MCP config `npx @llamaindex/mcp-server-llamacloud` with `node ./build/index.js`. ### Debugging Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the [MCP Inspector](https://github.com/modelcontextprotocol/inspector), which is available as a package script: ```bash npm run inspector ``` The Inspector will provide a URL to access debugging tools in your browser.