acuvity/mcp-server-elasticsearch

什么是mcp-server-elasticsearch?

该镜像由Acuvity打包，基于Elastic的mcp-server-elasticsearch原始源码构建，用于连接Elasticsearch执行自然语言数据查询。它提供安全的容器化运行环境，支持多种IDE和客户端集成。

核心功能

🔐 关键安全特性

📦 隔离不可变沙箱

🛡️ 运行时安全与防护

Minibridge集成：通过Minibridge建立安全的Agent-to-MCP连接，支持Rego/HTTP-based策略 enforcement，并简化编排。内置Rego策略提供以下防护：

使用场景

1. IDE集成：支持VS Code、Windsurf、Cursor、Claude Desktop等IDE的MCP服务器配置
2. 本地部署：通过Docker运行STDIO/HTTP/sse模式
3. 远程部署：通过WebSocket隧道和MTLS实现安全远程访问
4. Kubernetes部署：使用Helm Charts在K8s集群中部署

配置说明

环境变量要求

• ES_API_KEY：必填，Elasticsearch API密钥
• ES_URL：必填，Elasticsearch服务地址

Docker部署示例

本地HTTP/sse模式

bash
docker run -it -p 8000:8000 --rm --read-only -e ES_API_KEY=<your_key> -e ES_URL=<your_es_url> docker.xuanyuan.run/acuvity/mcp-server-elasticsearch:0.3.1

客户端配置示例（VS Code全局设置）

在Preferences: Open User Settings JSON中添加：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-elasticsearch": {
        "env": {
          "ES_API_KEY": "TO_BE_SET",
          "ES_URL": "TO_BE_SET"
        },
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "-e",
          "ES_API_KEY",
          "-e",
          "ES_URL",
          "docker.io/acuvity/mcp-server-elasticsearch:0.3.1"
        ]
      }
    }
  }
}

Kubernetes部署（Helm）

bash
helm install mcp-server-elasticsearch oci://docker.io/acuvity/mcp-server-elasticsearch --version 1.0.0 --set env.ES_URL=<your_es_url> --set secrets.ES_API_KEY.value=<your_key>

镜像签名验证

使用Cosign验证镜像完整性：

bash
cosign verify --certificate-oidc-issuer "https://token.actions.githubusercontent.com" --certificate-identity "https://github.com/acuvity/mcp-servers-registry/.github/workflows/release.yaml@refs/heads/main" docker.io/acuvity/mcp-server-elasticsearch:latest

支持与反馈

• 维护方：Acuvity团队（打包）、Elastic（原始源码）
• 帮助渠道：Acuvity MCP Forge仓库、***社区
• 问题反馈：GitHub Issue Tracker
• 联系***：***
• 贡献欢迎：欢迎提交PR改进镜像功能