acuvity/mcp-server-docker

立即开始，您可以使用以下“一键”链接：

全局范围

按ctrl + shift + p并输入Preferences: Open User Settings JSON，添加以下部分：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-docker": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "--read-only",
          "-v",
          "/var/run/docker.sock:/var/run/docker.sock",
          "docker.io/acuvity/mcp-server-docker:0.2.1"
        ]
      }
    }
  }
}

工作区范围

在您的工作区创建文件.vscode/mcp.json并添加以下部分：

json
{
  "servers": {
    "acuvity-mcp-server-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "-v",
        "/var/run/docker.sock:/var/run/docker.sock",
        "docker.io/acuvity/mcp-server-docker:0.2.1"
      ]
    }
  }
}

要传递密钥，您应使用https://code.visualstudio.com/docs/copilot/chat/mcp-servers中描述的`promptString`输入类型。

在~/.codeium/windsurf/mcp_config.json中添加以下部分：

json
{
  "mcpServers": {
    "acuvity-mcp-server-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "-v",
        "/var/run/docker.sock:/var/run/docker.sock",
        "docker.io/acuvity/mcp-server-docker:0.2.1"
      ]
    }
  }
}

更多信息请参见https://docs.windsurf.com/windsurf/mcp。

将以下JSON块添加到您的mcp配置文件：

• 全局范围：~/.cursor/mcp.json
• 项目范围：.cursor/mcp.json

json
{
  "mcpServers": {
    "acuvity-mcp-server-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "-v",
        "/var/run/docker.sock:/var/run/docker.sock",
        "docker.io/acuvity/mcp-server-docker:0.2.1"
      ]
    }
  }
}

更多信息请参见https://docs.cursor.com/context/model-context-protocol。

在claude_desktop_config.json配置文件中添加以下部分：

json
{
  "mcpServers": {
    "acuvity-mcp-server-docker": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "--read-only",
        "-v",
        "/var/run/docker.sock:/var/run/docker.sock",
        "docker.io/acuvity/mcp-server-docker:0.2.1"
      ]
    }
  }
}

更多信息请参见https://docs.anthropic.com/en/docs/agents-and-tools/mcp。

本地运行

python
async with MCPServerStdio(
    params={
        "command": "docker",
        "args": ["run","-i","--rm","--read-only","-v","/var/run/docker.sock:/var/run/docker.sock","docker.io/acuvity/mcp-server-docker:0.2.1"]
    }
) as server:
    tools = await server.list_tools()

远程运行

python
async with MCPServerSse(
    params={
        "url": "http://<ip>:<port>/sse",
    }
) as server:
    tools = await server.list_tools()

更多信息请参见https://openai.github.io/openai-agents-python/mcp/。

在您的客户端配置中设置：

• 命令：docker
• 参数：run -i --rm --read-only -v /var/run/docker.sock:/var/run/docker.sock docker.io/acuvity/mcp-server-docker:0.2.1

直接运行：

console
docker run -it -p 8000:8000 --rm --read-only -v /var/run/docker.sock:/var/run/docker.sock docker.xuanyuan.run/acuvity/mcp-server-docker:0.2.1

然后在您的应用/客户端中，可配置为：

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

您可能需要为不同工具使用不同端口。

本节假设您熟悉TLS和证书，需要：

• 具有与工具部署匹配的正确DNS/IP字段的服务器证书。
• 用于签署客户端证书的client-ca。

1. 以backend模式启动服务器：

   • 添加环境变量：-e MINIBRIDGE_MODE=backend
   • 通过卷添加TLS证书（推荐），例如/certs：-v $PWD/certs:/certs
   • 指示minibridge使用这些证书：
     • -e MINIBRIDGE_TLS_SERVER_CERT=/certs/server-cert.pem
     • -e MINIBRIDGE_TLS_SERVER_KEY=/certs/server-key.pem
     • -e MINIBRIDGE_TLS_SERVER_KEY_PASS=optional
     • -e MINIBRIDGE_TLS_SERVER_CLIENT_CA=/certs/client-ca.pem

2. 本地以frontend模式启动minibridge：

   • 获取适用于您操作系统的https://github.com/acuvity/minibridge二进制文件。

在您的客户端配置中，Minibridge像任何其他STDIO命令一样工作。例如Claude Desktop：

json
{
  "mcpServers": {
    "acuvity-mcp-server-docker": {
      "command": "minibridge",
      "args": ["frontend", "--backend", "wss://<remote-url>:8000/ws", "--tls-client-backend-ca", "/path/to/ca/that/signed/the/server-cert.pem/ca.pem", "--tls-client-cert", "/path/to/client-cert.pem", "--tls-client-key", "/path/to/client-key.pem"]
    }
  }
}

完成。Minibridge提供了许多附加功能。如需分步指南，请访问wiki。如有任何不清楚之处，请随时联系我们！

如何安装

您可以查看chart的README：

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

您可以查看可配置的values：

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

使用Helm安装：

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

默认情况下，您的MCP服务器mcp-server-docker可通过集群内的Kubernetes Service mcp-server-docker在端口8000上通过http/sse访问。您可以通过查看values.yaml文件的service部分进行更改。

如何监控

部署将创建一个带有healthPort的Kubernetes服务，用于活性探针和就绪探针。此健康端口也可用于您选择的监控堆栈，并在/metrics路径下公开指标。

有关设置和运行时安全（包括防护规则激活）的更多详细信息，请参见完整的charts https://github.com/acuvity/mcp-servers-registry/tree/main/mcp-server-docker/charts/mcp-server-docker/README.md。