mcp-server-llamacloud
A MCP server connecting to managed indexes on LlamaCloud
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/run-llama--mcp-server-llamacloud)HTML
<a href="/listings/run-llama--mcp-server-llamacloud"><img src="/api/listings/run-llama--mcp-server-llamacloud/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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.
{
"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:
--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.
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 100 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- > [!CAUTION]
- > This project is archived and no longer supported. See [the docs](https://developers.llamaindex.ai/for-agents/) for the latest on connecting your agent to LlamaParse Platform APIs.
- # 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.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.