acuvity/mcp-server-nmap

什么是mcp-server-nmap？

该镜像为连接Nmap网络扫描器与MCP（Model Context Protocol）标准化接口的桥接工具，用于安全测试场景。由Acuvity打包并发布至MCP registry，基于cyproxio/mcp-for-security源码构建，提供安全可靠的运行环境。

核心功能

隔离沙箱特性

运行时安全护栏

默认仅启用资源完整性护栏，其余可按需开启：

• 资源完整性：嵌入资源哈希，防止未授权修改
• 隐蔽指令检测：识别隐藏/混淆的请求指令
• 敏感模式检测：标记敏感数据或文件系统暴露模式
• 影子模式检测：识别覆盖或影响其他工具的描述
• schema合规性：强制输入数据严格符合schema
• 跨域工具访问：控制外部服务/API调用
• secrets脱敏：防止凭证或敏感值暴露
• 基础认证：通过共享密钥限制未授权访问

使用场景

• 渗透测试中的网络端口扫描与资产发现
• 漏洞评估中的目标系统安全状态检测
• 安全团队的合规性检查与基线验证
• 自动化安全工具链中的Nmap集成

配置说明

客户端集成

Visual Studio Code

全局配置：打开用户设置JSON，添加：

json
{
  "mcp": {
    "servers": {
      "acuvity-mcp-server-nmap": {
        "command": "docker",
        "args": ["run", "-i", "--rm", "--read-only", "docker.io/acuvity/mcp-server-nmap:6190e55"]
      }
    }
  }
}

工作区配置：创建.vscode/mcp.json，添加上述servers内容。

OpenAI Python SDK

本地运行：

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

Docker部署示例

本地HTTP/sse模式

bash
docker run -it -p 8000:8000 --rm --read-only docker.io/acuvity/mcp-server-nmap:6190e55

客户端配置使用http://localhost:8000/sse作为MCP服务器地址。

远程WebSocket隧道+MTLS

1. 启动后端模式服务器：

bash
docker run -it -p 8000:8000 --rm --read-only \
  -e MINIBRIDGE_MODE=backend \
  -v $PWD/certs:/certs \
  -e MINIBRIDGE_TLS_SERVER_CERT=/certs/server-cert.pem \
  -e MINIBRIDGE_TLS_SERVER_KEY=/certs/server-key.pem \
  -e MINIBRIDGE_TLS_SERVER_CLIENT_CA=/certs/client-ca.pem \
  docker.io/acuvity/mcp-server-nmap:6190e55

2. 本地启动minibridge前端：

bash
minibridge frontend --backend wss://<remote-url>:8000/ws \
  --tls-client-backend-ca /path/to/ca.pem \
  --tls-client-cert /path/to/client-cert.pem \
  --tls-client-key /path/to/client-key.pem

Kubernetes部署（Helm）

bash
# 查看Chart信息
helm show readme oci://docker.io/acuvity/mcp-server-nmap --version 1.0.0
# 安装Chart
helm install mcp-server-nmap oci://docker.io/acuvity/mcp-server-nmap --version 1.0.0

集群内通过http://mcp-server-nmap:8000/sse访问服务。