acuvity/mcp-server-exa

mcp-server-exa镜像说明

镜像概述

mcp-server-exa是Acuvity基于exa-labs原代码打包的MCP服务器镜像，核心功能是支持AI模型执行实时网页搜索。该镜像注重安全设计，提供隔离执行环境、最小权限原则等保障，可无缝集成到VS Code、Cursor等IDE及Claude、OpenAI SDK等AI客户端。

核心功能

隔离不可变沙箱

• 隔离执行：工具在容器化沙箱内运行，防止横向渗透。
• 非root默认：遵循最小权限原则，降低漏洞影响范围。
• 只读文件系统：确保运行时不可变性，避免未授权修改。
• 版本固定：锁定工具和依赖版本，保证部署一致性。
• CVE扫描：通过Docker Scout持续检测已知漏洞。
• SBOM与溯源：嵌入元数据和构建信息，提升供应链透明度。
• 容器签名：使用Cosign签名，确保镜像完整性和真实性。

运行时安全防护

• Minibridge集成：提供安全的Agent-MCP连接，支持Rego/HTTP政策管控。
• 内置防护规则：包含资源完整性校验、隐蔽指令检测、敏感数据识别等（默认仅启用资源完整性，可按需配置）。

使用场景

• AI助手实时获取网页信息（如开发辅助、内容创作、知识查询）。
• 企业/个人需要安全可靠的AI工具集成环境。

配置说明

环境变量

• EXA_API_KEY：必填，用于访问Exa服务的API密钥。

Docker部署示例

本地STDIO模式

客户端配置：

• 命令：docker
• 参数：run -i --rm --read-only -e EXA_API_KEY docker.io/acuvity/mcp-server-exa:3.1.4

本地HTTP/sse模式

运行命令：

bash
docker run -it -p 8000:8000 --rm --read-only -e EXA_API_KEY docker.xuanyuan.run/acuvity/mcp-server-exa:3.1.4

客户端配置：

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

IDE集成（VS Code）

用户设置JSON添加：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-exa": {
        "env": { "EXA_API_KEY": "你的密钥" },
        "command": "docker",
        "args": ["run", "-i", "--rm", "--read-only", "-e", "EXA_API_KEY", "docker.io/acuvity/mcp-server-exa:3.1.4"]
      }
    }
  }
}

Kubernetes部署（Helm）

安装命令：

bash
helm install mcp-server-exa oci://docker.io/acuvity/mcp-server-exa --version 1.0.0

需提前配置EXA_API_KEY密钥，详情参考Helm Chart文档。