acuvity/mcp-server-aws-kendra-index

什么是mcp-server-aws-kendra-index？

该镜像由Acuvity打包并发布至其MCP服务器 registry，基于awslabs.amazon-kendra-index-mcp-server的原始源码，旨在为AI助手提供访问Amazon Kendra搜索索引的能力，以增强检索增强生成（RAG）的上下文信息。

核心功能

🔐 关键安全特性

📦 隔离不可变沙箱

🛡️ 运行时安全与护栏

Minibridge集成：Minibridge建立安全的Agent-to-MCP连接，支持Rego/HTTP-based政策执行，并简化编排。容器内置Rego政策，提供一系列运行时护栏以确保安全、隐私和服务的正确使用：

[!NOTE] 默认情况下，除“资源完整性”外的所有护栏均关闭，可单独启用或禁用，确保仅激活环境所需的保护。

使用场景

• 企业AI助手：通过访问Amazon Kendra索引获取企业知识库信息，提升回答准确性
• 客户支持AI：快速检索产品文档或常见问题，提供精准解答
• 研发辅助工具：帮助开发者从技术文档中获取相关信息，加速开发流程

配置说明

环境变量与密钥

• 必填：KENDRA_INDEX_ID（Amazon Kendra索引ID）
• 可选：
  • AWS_PROFILE（AWS配置文件）
  • AWS_REGION（AWS区域）
  • AWS_ACCESS_KEY_ID（AWS访问密钥ID）
  • AWS_SECRET_ACCESS_KEY（AWS秘密访问密钥）
  • AWS_SESSION_TOKEN（AWS会话令牌）

Docker部署示例

本地STDIO模式

在客户端配置中设置：

• 命令：docker
• 参数：run -i --rm --read-only -e KENDRA_INDEX_ID docker.io/acuvity/mcp-server-aws-kendra-index:1.0.12

本地HTTP/sse模式

运行命令：

console
docker run -it -p 8000:8000 --rm --read-only -e KENDRA_INDEX_ID docker.io/acuvity/mcp-server-aws-kendra-index:1.0.12

客户端配置示例：

json
{
  "mcpServers": {
    "acuvity-mcp-server-aws-kendra-index": {
      "url": "http://localhost:8000/sse"
    }
  }
}

Kubernetes部署（Helm）

安装命令：

console
helm install mcp-server-aws-kendra-index oci://docker.io/acuvity/mcp-server-aws-kendra-index --version 1.0.0

需配置必填环境变量KENDRA_INDEX_ID，可选AWS相关密钥（通过secrets设置）。

IDE集成示例

Visual Studio Code（全局配置）

在用户设置JSON中添加：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-aws-kendra-index": {
        "env": {
          "KENDRA_INDEX_ID": "TO_BE_SET"
        },
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "-e",
          "KENDRA_INDEX_ID",
          "docker.io/acuvity/mcp-server-aws-kendra-index:1.0.12"
        ]
      }
    }
  }
}

OpenAI Python SDK（本地运行）

python
async with MCPServerStdio(
    params={
        "env": {"KENDRA_INDEX_ID":"TO_BE_SET"},
        "command": "docker",
        "args": ["run","-i","--rm","--read-only","-e","KENDRA_INDEX_ID","docker.io/acuvity/mcp-server-aws-kendra-index:1.0.12"]
    }
) as server:
    tools = await server.list_tools()