使用说明

项目简介

LlamaCloud MCP Server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它连接到 LlamaCloud 提供的托管索引服务。通过这个服务器，LLM 客户端可以利用 LlamaCloud 上的知识库进行信息检索，从而增强 LLM 的上下文理解和问答能力。

主要功能点

知识库访问: 连接到 LlamaCloud 托管的知识库索引。
信息检索工具: 提供 'get_information' 工具，允许 LLM 客户端查询知识库并获取相关信息。
标准 MCP 协议: 遵循 MCP 协议标准，易于与各种 MCP 客户端集成，例如 Claude Desktop。
基于 Stdio 传输: 使用标准输入输出流 (stdio) 作为通信协议，简化部署和集成。

安装步骤

安装依赖: 在项目根目录下运行以下命令安装项目依赖：
```
npm install
```
构建服务器: 运行以下命令构建服务器代码：
```
npm run build
```

服务器配置

MCP 服务器需要配置才能被 MCP 客户端（如 Claude Desktop）识别和连接。以下是 Claude Desktop 客户端的 'claude_desktop_config.json' 配置文件示例，您需要根据实际情况进行修改。

{
  "mcpServers": {
    "llamacloud": {  // 服务器名称，可以自定义
      "command": "node", // 启动服务器的命令，这里使用 node.js 运行时
      "args": [
        "/path/to/llamacloud/build/index.js" //  'index.js' 文件的绝对路径，请替换为实际路径
      ],
      "env": {
        "LLAMA_CLOUD_INDEX_NAME": "<YOUR_INDEX_NAME>",  //  您的 LlamaCloud 索引名称，请替换为实际值
        "LLAMA_CLOUD_PROJECT_NAME": "<YOUR_PROJECT_NAME>", // 您的 LlamaCloud 项目名称，请替换为实际值
        "LLAMA_CLOUD_API_KEY": "<YOUR_API_KEY>" // 您的 LlamaCloud API 密钥，请替换为实际值
      }
    }
  }
}

配置说明:

'"llamacloud"': 是您为该 MCP 服务器自定义的名称，在 Claude Desktop 客户端中用于标识和选择该服务器。
'"command"': 指定启动 MCP 服务器的命令，这里是 'node'，表示使用 Node.js 运行时环境。
'"args"': 是一个字符串数组，包含了传递给 'command' 的参数。这里 '/path/to/llamacloud/build/index.js' 需要替换为 'index.js' 文件在您本地文件系统中的绝对路径。
'"env"': 是一个对象，用于设置服务器运行时的环境变量。
- '"LLAMA_CLOUD_INDEX_NAME"': 必须配置，替换为您的 LlamaCloud 索引名称。
- '"LLAMA_CLOUD_PROJECT_NAME"': 必须配置，替换为您的 LlamaCloud 项目名称。
- '"LLAMA_CLOUD_API_KEY"': 必须配置，替换为您的 LlamaCloud API 密钥。您可以在 LlamaCloud 控制台中获取 API 密钥。

请务必将 '<YOUR_INDEX_NAME>'、'<YOUR_PROJECT_NAME>'、'<YOUR_API_KEY>' 和 '/path/to/llamacloud/build/index.js' 替换为您的实际信息。 'claude_desktop_config.json' 文件的位置请参考 README.md 中的说明 (MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json', Windows: '%APPDATA%/Claude/claude_desktop_config.json')。

基本使用方法

启动 MCP 服务器: 配置完成后，当 Claude Desktop 等 MCP 客户端启动时，会自动尝试连接您配置的 MCP 服务器。
使用 'get_information' 工具: 在 Claude Desktop 中，当需要使用知识库信息时，客户端会调用 MCP 服务器提供的 'get_information' 工具。您可以通过自然语言指令，例如 "请从知识库中查找关于...的信息"，来触发该工具。
提供查询参数: 'get_information' 工具需要 'query' 参数，即您要查询的内容。客户端会将您的问题作为 'query' 参数传递给 MCP 服务器。
获取查询结果: MCP 服务器会连接到 LlamaCloud 索引，执行查询，并将检索到的相关文本内容返回给客户端。客户端会将这些信息作为上下文，辅助生成更准确和有信息量的回复。

注意: 您需要先在 LlamaCloud 上创建索引并上传数据，才能使用此 MCP 服务器进行知识库查询。

关键词