LlamaCloud

[!CAUTION] Este proyecto está archivado y ya no recibe soporte. Consulta la documentación para obtener la información más reciente sobre cómo conectar tu agente a las APIs de la plataforma LlamaParse.

Servidor MCP de LlamaCloud

Un servidor MCP que se conecta a múltiples índices gestionados en LlamaCloud

Este es un servidor MCP basado en TypeScript que crea múltiples herramientas, cada una conectada a un índice gestionado específico en LlamaCloud. Cada herramienta se define mediante argumentos de línea de comandos.

Características

Herramientas

• Crea una herramienta separada para cada índice que definas
• Cada herramienta proporciona un parámetro query para buscar en su índice específico
• Genera automáticamente nombres de herramientas como get_information_index_name basados en los nombres de los índices

Instalación

Para usar con tu cliente MCP (por ejemplo, Claude Desktop, Windsurf o Cursor), añade la siguiente configuración a la configuración de tu cliente MCP:

La variable de entorno LLAMA_CLOUD_PROJECT_NAME es opcional y por defecto es Default si no se establece.

{
  "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, la configuración de MCP se puede encontrar en:

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

Formato de definición de herramientas

En el array args de la configuración de MCP, puedes definir múltiples herramientas proporcionando pares de argumentos --index y --description. Cada par define una nueva herramienta. También puedes especificar opcionalmente --topK para limitar el número de resultados.

Por ejemplo:

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

Añade una herramienta para el índice de LlamaCloud 10k-SEC-Tesla al servidor MCP. En este ejemplo, está configurado para devolver los 5 mejores resultados.

Desarrollo

Instala las dependencias:

npm install

Compila el servidor:

npm run build

Para desarrollo con reconstrucción automática:

npm run watch

Para usar la versión de desarrollo, reemplaza en tu configuración de MCP npx @llamaindex/mcp-server-llamacloud por node ./build/index.js.

Depuración

Dado que los servidores MCP se comunican a través de stdio, la depuración puede ser desafiante. Recomendamos usar el Inspector MCP, que está disponible como script de paquete:

npm run inspector

El Inspector proporcionará una URL para acceder a las herramientas de depuración en tu navegador.