mcpField
L
LlamaCloud MCP Server

LlamaCloud MCP Server

本地服务
github.com/run-llamaAI 与智能体8712 周前更新
代码仓库

关于 LlamaCloud MCP Server

LlamaCloud MCP 服务可将 LlamaCloud 上的托管索引连接到 MCP 客户端。每个索引会生成一个独立的查询工具，适合希望在 AI 助手中检索指定文档集合的用户。该项目已归档，不再维护。

主要功能

  1. 01为每个索引生成单独的查询工具
  2. 02通过命令行参数配置索引与描述
  3. 03可选的 topK 结果数量限制
  4. 04支持 MCP Inspector 调试

适用场景

  1. 01在 Claude Desktop 中查询 SEC 财报文档
  2. 02在 Cursor 或 Windsurf 中检索托管索引内容
#llamacloud#mcp-server#managed-index

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "llamacloud": {
      "command": "npx",
      "args": [
        "-y",
        "@llamaindex/mcp-server-llamacloud"
      ],
      "env": {
        "LLAMA_CLOUD_API_KEY": "<LLAMA_CLOUD_API_KEY>"
      }
    }
  }
}
启动命令npx -y @llamaindex/mcp-server-llamacloud
需要配置的环境变量
LLAMA_CLOUD_API_KEY密钥

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@llamaindex/mcp-server-llamacloud

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

注意

此项目已归档，不再提供支持。有关将 Agent 连接到 LlamaParse Platform API 的最新信息，请参阅文档。

LlamaCloud MCP 服务

一个可连接到 LlamaCloud 上多个托管索引的 MCP 服务

这是一个基于 TypeScript 的 MCP 服务，可创建多个工具，每个工具连接到 LlamaCloud 上的一个特定托管索引。每个工具都通过命令行参数定义。

LlamaCloud Server MCP server

功能

工具
  • 为定义的每个索引分别创建一个工具
  • 每个工具都提供一个 query 参数，用于搜索其对应的索引
  • 根据索引名称自动生成类似 get_information_index_name 的工具名称

安装

要在 MCP 客户端（例如 Claude Desktop、Windsurf 或 Cursor）中使用，请将以下配置添加到 MCP 客户端配置中：

LLAMA_CLOUD_PROJECT_NAME 环境变量为可选项；如果未设置，默认值为 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>"
      }
    }
  }
}

Claude 的 MCP 配置位于：

  • 在 MacOS 上：~/Library/Application Support/Claude/claude_desktop_config.json
  • 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json
工具定义格式

在 MCP 配置的 args 数组中，可以通过提供成对的 --index 和 --description 参数来定义多个工具。每一对参数都会定义一个新工具。也可以选择指定 --topK 来限制结果数量。

例如：

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

这会为 MCP 服务添加一个工具，用于查询 LlamaCloud 索引 10k-SEC-Tesla。此示例配置为返回前 5 个结果。

开发

安装依赖项：

npm install

构建服务：

npm run build

启用自动重建以进行开发：

npm run watch

要使用开发版本，请在 MCP 配置中将 npx @llamaindex/mcp-server-llamacloud 替换为 node ./build/index.js。

调试

由于 MCP 服务通过 stdio 进行通信，调试可能颇具挑战。我们建议使用 MCP Inspector，它可通过包脚本运行：

npm run inspector

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。