Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/run-llama--mcp-server-llamacloud/badge.svg)](/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

i

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)

  1. > [!CAUTION]
  2. > 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.
  3. # LlamaCloud MCP Server
  4. A MCP server connecting to multiple managed indexes on [LlamaCloud](https://cloud.llamaindex.ai/)
  5. 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.
  6. <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>
  7. ## Features
  8. ### Tools
  9. - Creates a separate tool for each index you define
  10. - Each tool provides a `query` parameter to search its specific index
  11. - Auto-generates tool names like `get_information_index_name` based on index names
  12. ## Installation
  13. To use with your MCP Client (e.g. Claude Desktop, Windsurf or Cursor), add the following config to your MCP client config:
  14. The `LLAMA_CLOUD_PROJECT_NAME` environment variable is optional and defaults to `Default` if not set.
  15. ```json
  16. {
  17. "mcpServers": {
  18. "llamacloud": {
  19. "command": "npx",
  20. "args": [
  21. "-y",
  22. "@llamaindex/mcp-server-llamacloud",
  23. "--index",
  24. "10k-SEC-Tesla",
  25. "--description",
  26. "10k SEC documents from 2023 for Tesla",
  27. "--topK",
  28. "5",
  29. "--index",
  30. "10k-SEC-Apple",
  31. "--description",
  32. "10k SEC documents from 2023 for Apple"
  33. ],
  34. "env": {
  35. "LLAMA_CLOUD_API_KEY": "<YOUR_API_KEY>"
  36. }
  37. }
  38. }
  39. }
  40. ```
  41. For Claude, the MCP config can be found at:
  42. - On MacOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
  43. - On Windows: `%APPDATA%/Claude/claude_desktop_config.json`
  44. ### Tool Definition Format
  45. 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.
  46. For example:
  47. ```bash
  48. --index "10k-SEC-Tesla" --description "10k SEC documents from 2023 for Tesla" --topK 5
  49. ```
  50. 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.
  51. ## Development
  52. Install dependencies:
  53. ```bash
  54. npm install
  55. ```
  56. Build the server:
  57. ```bash
  58. npm run build
  59. ```
  60. For development with auto-rebuild:
  61. ```bash
  62. npm run watch
  63. ```
  64. To use the development version, replace in your MCP config `npx @llamaindex/mcp-server-llamacloud` with `node ./build/index.js`.
  65. ### Debugging
  66. 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:
  67. ```bash
  68. npm run inspector
  69. ```
  70. The Inspector will provide a URL to access debugging tools in your browser.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.