AWS Qindex MCP Server

AWS Qindex MCP Server

AWS Qindex MCP 服务器允许 AI 应用通过模型上下文协议安全、无缝地访问 Amazon Q Index 数据。这使得语言模型和自主助手能够对企业文档索引进行自然语言搜索、检索和分析。

Author: awslabs


查看协议

什么是 AWS Qindex MCP 服务器？

AWS Qindex MCP 服务器是一个专用的服务器组件，通过标准化的模型上下文协议 (MCP) 提供 Amazon Q Index 的搜索和数据检索功能。它使 AI 代理、基于 LLM 的编码助手和自动化工具能够将 Q Index 作为上下文数据源，轻松执行语义文档搜索、回答索引文档中的问题，并在生成 AI 工作流中利用企业知识。

如何配置

要设置 AWS Qindex MCP 服务器：

  1. 前提条件：
    • 确保已安装 Python（推荐使用 uv）。
    • 配置 AWS 配置文件/凭证，并允许访问 Q Index。
    • 根据应用需求使用 uvx 或作为 Docker 容器安装 MCP 服务器。
  2. 添加到您的 MCP 客户端配置： 在 MCP 客户端的配置文件中添加一个条目（例如 ~/.aws/amazonq/mcp.json、.cursor/mcp.json 等）： 
    {
  "mcpServers": {
    "awslabs.qindex-mcp-server": {
      "command": "uvx",
      "args": ["awslabs.qindex-mcp-server@latest"],
      "env": {
        "AWS_PROFILE": "your-aws-profile",
        "AWS_REGION": "your-aws-region",
        "FASTMCP_LOG_LEVEL": "ERROR"
      }
    }
  }
}
  3. 环境变量和权限：
    • 根据需要设置 AWS_PROFILE 和 AWS_REGION 的值。
    • 确保您的 IAM 用户或角色具有访问 Amazon Q Index API 的权限。
    • 可选地配置任何特定的 Q Index 标识符或工作流所需的自定义环境变量。
  4. 测试连接： 使用您的 MCP 客户端接口检查服务器是否可发现，并返回 /tools/list 下的可用工具。

如何使用

  1. 自主助手集成：
    • 通过您的 AI 编码助手或聊天界面（如 Amazon Q、Cursor、Windsurf、Claude Desktop）使用自然语言提示进行搜索或检索 Q Index 的内容。
    • LLM 使用 MCP 协议向 Qindex 服务器查询相关文档或答案。
  2. 直接调用工具：
    • 通过您的 MCP 客户端使用 tools/list 列出可用功能（工具）。
    • 使用 tools/call 接口调用 Q Index 搜索操作，传递查询参数如关键字或文档过滤器。
    • 聊天示例："使用 Qindex MCP 服务器，搜索有关 AWS Lambda 的最新架构指南。"
  3. 上下文补全：
    • 开启后，Q Index 的结果可以嵌入到语言模型的上下文窗口中，以提高代码、文档或研究输出的准确性和事实依据。
  4. 多代理工作流：
    • 将 Qindex MCP 服务器的响应与其他 MCP 服务器（如 AWS 文档或成本分析）结合，实现复杂的跨领域推理和自动化。

主要特点

  • 实时语义搜索： 通过自然语言或基于关键字的查询访问您的企业 Q Index。
  • LLM 准备好的结构化结果： 返回结构化上下文的数据，适合注入 LLM 提示或代理工作流。
  • 授权继承： 利用您现有的 AWS IAM 实现细粒度、安全的数据访问。
  • 企业知识集成： 无缝将组织的 Q Index 知识带入 AI 驱动的编码助手和代理中。
  • 工具发现与调用： 公开可发现、可组合的功能（MCP 工具）以搜索、过滤和检索索引内容。
  • 引用和参考： 结果可以包含源/文档元数据，便于准确追踪和审计。
  • 与其他 MCP 服务器的组合： 灵活集成补充上下文/数据提供者，实现全栈 AI 开发。

使用案例

  • 企业知识搜索： 通过自然语言在策划的 Q Index 中快速回答商业、工程或合规问题。
  • 研究助手： 检索企业内最新的架构模式、安全指南或最佳实践，为上下文感知的代码生成提供支持。
  • 对话问答： 为聊天机器人、虚拟助手或支持代理提供基于权威内部文档的响应能力。
  • 自动化代码生成： 用从 Q Index 检索的组织特定参考和最佳实践补充 LLM 代码输出。
  • 合规和安全审计： 快速定位与审计或合规查询相关的政策和文档。
  • 自定义工作流： 启用多工具链，从 Amazon Q Index 中检索的信息指导或约束其他 MCP 集成工具的行为。

常见问题

Q1：运行 AWS Qindex MCP 服务器需要什么权限？
要访问 Amazon Q Index 数据，您的 AWS 配置文件或凭证必须具有相关 Q Index API 的权限（例如 qindex:Search 或其他细粒度权限）。请咨询您的安全团队以确保合规访问。

Q2：我可以将 Qindex MCP 服务器与多个 Q Index 或租户一起使用吗？
是的，您可以指定不同的 Q Index 标识符，或在 MCP 客户端配置中配置多个条目，以根据需要将查询路由到不同的 Q Index 数据源。

Q3：AWS Qindex MCP 服务器如何处理敏感或受限数据？
数据访问、过滤和授权使用您的 AWS 安全上下文进行强制。只有拥有正确权限的用户或角色才能检索到匹配的结果。

Q4：Qindex MCP 服务器返回什么格式或内容类型？
工具响应包括结构化 JSON 负载，包含 ID、摘要、标题、文档元数据，并可选地包含全文，适合嵌入到 LLM 上下文窗口或下游处理。

Q5：我如何排查连接性或服务器启动问题？
检查您的 AWS 凭证是否设置、区域是否正确，以及您的 IAM 策略是否授予所需的 Q Index 权限。使用 MCP 客户端的日志（设置 FASTMCP_LOG_LEVEL=DEBUG）进行进一步诊断。