LlamaCloud

LlamaCloud

Integrate the data stored in a managed index on LlamaCloud

83
Stars
18
Forks
3
Releases

Overview

LlamaCloud MCP Server is a TypeScript-based MCP server that creates multiple tools, each connected to a specific managed index on LlamaCloud. Tools are defined through command-line arguments, with the server automatically generating a separate tool for every index you define. Each tool exposes a query parameter to search its assigned index, enabling targeted retrieval from multiple managed indexes within a single MCP session. Tool names are auto-generated from the index names (e.g., get_information_index_name) to provide consistent, predictable access across indexes. Installation and configuration are designed to work with MCP clients such as Claude Desktop, Windsurf, or Cursor. The MCP config can declare multiple index/description pairs and may include --topK to limit results. A LLAMA_CLOUD_API_KEY environment variable is required for authentication, and LLAMA_CLOUD_PROJECT_NAME is optional with a default of Default. Development workflows include npm install, npm run build, and npm run watch, plus debugging via the MCP Inspector, which can be run with npm run inspector to obtain a browser-accessible debugging URL.

Details

Owner
run-llama
Language
JavaScript
License
MIT License
Updated
2025-12-07

Features

Multi-index tool creation

Creates a separate tool for each defined LlamaCloud index.

Index-specific querying

Each tool provides a query parameter to search its assigned index.

Auto-generated tool names

Tool names are automatically derived from index names, e.g., get_information_index_name.

Config-driven tool definition

Define multiple tools by pairing --index and --description in the MCP config; optional --topK to limit results.

Environment-based authentication

Uses LLAMA_CLOUD_API_KEY for authentication; LLAMA_CLOUD_PROJECT_NAME is optional with default 'Default'.

Audience

MCP client usersConnects multiple managed indexes to a single MCP server for querying via generated tools.
DevelopersBuilds and uses per-index tools in MCP clients to query LlamaCloud.
DevOps/InfraDeploys and maintains MCP servers integrating LlamaCloud managed indexes.

Tags

LlamaCloudMCP serverTypeScripttoolsmanaged indexesindex-based toolsqueryCLItopKauto-generated tool names