LlamaCloud

[!CAUTION] Este projeto está arquivado e não é mais suportado. Consulte a documentação para obter as informações mais recentes sobre como conectar seu agente às APIs da Plataforma LlamaParse.

Servidor MCP LlamaCloud

Um servidor MCP que se conecta a múltiplos índices gerenciados no LlamaCloud

Este é um servidor MCP baseado em TypeScript que cria múltiplas ferramentas, cada uma conectada a um índice gerenciado específico no LlamaCloud. Cada ferramenta é definida por meio de argumentos de linha de comando.

Recursos

Ferramentas

• Cria uma ferramenta separada para cada índice que você definir
• Cada ferramenta fornece um parâmetro query para pesquisar em seu índice específico
• Gera automaticamente nomes de ferramentas como get_information_index_name com base nos nomes dos índices

Instalação

Para usar com seu Cliente MCP (ex.: Claude Desktop, Windsurf ou Cursor), adicione a seguinte configuração ao config do seu cliente MCP:

A variável de ambiente LLAMA_CLOUD_PROJECT_NAME é opcional e, se não for definida, assume o padrão 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>"
      }
    }
  }
}

Para Claude, o config do MCP pode ser encontrado em:

• No MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• No Windows: %APPDATA%/Claude/claude_desktop_config.json

Formato de Definição de Ferramenta

No array args do config do MCP, você pode definir múltiplas ferramentas fornecendo pares de argumentos --index e --description. Cada par define uma nova ferramenta. Você também pode opcionalmente especificar --topK para limitar o número de resultados.

Por exemplo:

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

Adiciona uma ferramenta para o índice 10k-SEC-Tesla do LlamaCloud ao servidor MCP. Neste exemplo, está configurado para retornar os 5 principais resultados.

Desenvolvimento

Instale as dependências:

npm install

Compile o servidor:

npm run build

Para desenvolvimento com recompilação automática:

npm run watch

Para usar a versão de desenvolvimento, substitua no seu config do MCP npx @llamaindex/mcp-server-llamacloud por node ./build/index.js.

Depuração

Como os servidores MCP se comunicam via stdio, a depuração pode ser desafiadora. Recomendamos usar o Inspector MCP, que está disponível como um script de pacote:

npm run inspector

O Inspector fornecerá uma URL para acessar as ferramentas de depuração no seu navegador.