acuvity/mcp-server-bitrefill

mcp-server-bitrefill镜像概述

该镜像由Acuvity打包发布，基于Bitrefill开源项目（bitrefill-mcp-server），通过模型上下文协议（MCP）为AI助手提供Bitrefill服务。镜像以安全为核心设计，确保服务可靠运行，支持多客户端集成与多种部署方式。

核心功能

安全隔离沙箱

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

运行时安全防护

• Minibridge集成：提供Agent到MCP的安全连接，支持Rego/HTTP政策管控，简化编排流程。
• 内置Rego政策：包含资源完整性、隐蔽指令检测、敏感模式识别等防护能力，默认仅启用资源完整性，可按需配置。

使用场景

• 本地开发：在IDE中快速集成，测试Bitrefill服务与AI助手的交互逻辑。
• 远程部署：通过WebSocket隧道+MTLS实现安全的跨网络访问。
• 集群部署：利用Helm Charts在Kubernetes中规模化部署与监控。

配置说明

环境变量要求

• BITREFILL_API_ID：必填，Bitrefill平台API标识。
• BITREFILL_API_SECRET：必填，Bitrefill平台API密钥。

客户端集成

Visual Studio Code

全局配置（用户设置JSON）：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-bitrefill": {
        "env": {
          "BITREFILL_API_ID": "TO_BE_SET",
          "BITREFILL_API_SECRET": "TO_BE_SET"
        },
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "-e",
          "BITREFILL_API_ID",
          "-e",
          "BITREFILL_API_SECRET",
          "docker.io/acuvity/mcp-server-bitrefill:0.3.0"
        ]
      }
    }
  }
}

工作区配置：在.vscode/mcp.json中添加上述内容。

OpenAI Python SDK

本地运行示例：

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

Docker部署示例

本地HTTP/sse模式

console
docker run -it -p 8000:8000 --rm --read-only -e BITREFILL_API_ID -e BITREFILL_API_SECRET docker.io/acuvity/mcp-server-bitrefill:0.3.0

客户端配置引用：

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

Kubernetes部署（Helm）

安装命令：

console
helm install mcp-server-bitrefill oci://docker.io/acuvity/mcp-server-bitrefill --version 1.0.0

查看Chart详情：

console
helm show readme oci://docker.io/acuvity/mcp-server-bitrefill --version 1.0.0