acuvity/mcp-server-axiom

mcp-server-axiom 镜像说明

镜像概述

mcp-server-axiom是Acuvity基于axiomhq原始源码安全包装的Docker镜像，核心功能为通过自然语言查询和分析Axiom日志、追踪及事件数据。镜像具备严格的安全特性，确保运行可靠且符合最小权限原则。

核心功能

🔐 隔离不可变沙箱

🛡️ 运行时安全护栏

集成Minibridge实现安全连接，内置Rego策略支持以下护栏（默认仅资源完整性启用）：

使用场景

1. IDE集成：支持VS Code、Windsurf、Cursor、Claude Desktop、OpenAI Python SDK等客户端，提升AI辅助体验。
2. 本地部署：通过Docker以STDIO或HTTP/sse模式运行。
3. 远程部署：通过WebSocket隧道+MTLS实现安全远程访问。
4. K8s部署：用Helm Chart在集群部署，支持监控与健康检查。

配置说明

环境变量要求

• AXIOM_TOKEN：必填，Axiom访问令牌
• AXIOM_URL：必填，Axiom服务地址
• AXIOM_ORG：必填，Axiom组织ID

部署示例

Docker本地运行（HTTP/sse模式）

bash
docker run -it -p 8000:8000 --rm --read-only \
  -e AXIOM_TOKEN=<你的令牌> \
  -e AXIOM_URL=<你的服务地址> \
  -e AXIOM_ORG=<你的组织ID> \
  docker.xuanyuan.run/acuvity/mcp-server-axiom:v0.0.5

Kubernetes Helm部署

bash
helm install mcp-server-axiom oci://docker.io/acuvity/mcp-server-axiom --version 1.0.0 \
  --set env.AXIOM_URL=<你的服务地址> \
  --set secrets.AXIOM_TOKEN.value=<你的令牌> \
  --set secrets.AXIOM_ORG.value=<你的组织ID>

VS Code集成（全局配置）

打开用户设置JSON添加：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-axiom": {
        "env": {"AXIOM_ORG":"TO_BE_SET","AXIOM_TOKEN":"TO_BE_SET","AXIOM_URL":"TO_BE_SET"},
        "command":"docker",
        "args":["run","-i","--rm","--read-only","-e","AXIOM_TOKEN","-e","AXIOM_URL","-e","AXIOM_ORG","docker.io/acuvity/mcp-server-axiom:v0.0.5"]
      }
    }
  }
}

[!NOTE] 更多配置细节请参考https://github.com/acuvity/mcp-servers-registry或联系***获取帮助。