Cyberbro MCP Server

Cyberbro MCP 服务

从杂乱文本中提取 IoC，并使用 Cyberbro 进行分析。
🌐 demo.cyberbro.net

Cyberbro 的 Model Context Protocol 服务。

此项目打包为标准 Python 发行包，可通过以下方式启动：

• uvx mcp-cyberbro
• pip install mcp-cyberbro，然后运行 mcp-cyberbro

为什么使用此服务

• 通过 Cyberbro 引擎分析可观测对象（IP、域名、URL、哈希等）。
• 将威胁分析操作直接集成到支持 MCP 的助手中。
• 使用 stdio、sse 或 streamable-http 传输方式运行。
• 兼容支持上述任一传输方式的所有 MCP 客户端。

安装

使用 uvx（独立运行）

uvx mcp-cyberbro --cyberbro_url http://localhost:5000

使用 pip

pip install mcp-cyberbro
mcp-cyberbro --cyberbro_url http://localhost:5000

本地开发

pip install -e .
mcp-cyberbro --cyberbro_url http://localhost:5000

Docker

默认容器命令会以 streamable-http 模式在端口 8000 上启动。

docker run --rm -p 8000:8000 \
  -e CYBERBRO_URL=http://host.docker.internal:5000 \
  ghcr.io/stanfrbd/mcp-cyberbro:latest

若要以 stdio 模式运行，需要使用自定义 Dockerfile：

FROM ghcr.io/stanfrbd/mcp-cyberbro:latest
CMD ["mcp-cyberbro", "--transport", "stdio"]

构建并使用：

docker build -t mcp-cyberbro-stdio .
docker run -i --rm -e CYBERBRO_URL=http://host.docker.internal:5000 mcp-cyberbro-stdio

配置

复制 .env.example 并至少设置：

• CYBERBRO_URL（必填）

支持的环境变量：

• CYBERBRO_URL
• API_PREFIX（默认值：api）
• SSL_VERIFY（true/false）
• MCP_TRANSPORT（stdio、sse、streamable-http）
• MCP_HOST
• MCP_PORT
• MCP_MOUNT_PATH
• MCP_SSE_PATH
• MCP_STREAMABLE_HTTP_PATH

也可使用 CLI 标志；其值会覆盖环境变量。

MCP 客户端集成

你可以将此服务与 Claude Desktop、Claude Code、Cursor、兼容 OpenAI 的 MCP 客户端或任何其他 MCP 客户端搭配使用。

使用 uvx 的配置示例：

{
  "mcpServers": {
    "cyberbro": {
      "command": "uvx",
      "args": ["mcp-cyberbro"],
      "env": {
        "CYBERBRO_URL": "http://localhost:5000"
      }
    }
  }
}

若要将 Docker 与 stdio 传输方式搭配使用（某些 MCP 客户端要求如此），请按照上方 Docker 章节所示构建自定义镜像，然后引用该镜像：

{
  "mcpServers": {
    "cyberbro": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "CYBERBRO_URL", "mcp-cyberbro-stdio"],
      "env": {
        "CYBERBRO_URL": "http://localhost:5000"
      }
    }
  }
}

在 VSCode 中使用 - 示例

创建 .vscode/mcp.json

{
	"servers": {
		"mcp-cyberbro": {
			"type": "stdio",
			"command": "uvx",
			"args": [
				"mcp-cyberbro"
			],
			"env": {
				"CYBERBRO_URL": "http://127.0.0.1:5000"
			}
		}
	}
}

MCP 注册表元数据

此项目包含 server.json，用于发布到 MCP Registry，并指向 PyPI 软件包 mcp-cyberbro。

发布流水线

发布时创建的工作流：

• .github/workflows/publish-test-pypi.yml
• .github/workflows/publish-pypi.yml
• .github/workflows/publish-mcp-plugin.yml

可用工具

• analyze_observable
• is_analysis_complete
• get_analysis_results
• get_engines
• get_web_url

提示词示例

以下是一些实用的提示词示例，可与任何连接到 Cyberbro 且支持 MCP 的助手搭配使用。

获取指标详情

• Cyberbro：检查 target.com 的指标
• 你能用 Cyberbro 检查此 IP 的信誉吗？192.168.1.1。请使用 github、google 和 virustotal 引擎。
• 我想分析域名 example.com。Cyberbro 能告诉我什么？最多使用 3 个引擎。
• 使用 Cyberbro 分析这些可观测对象：suspicious-domain.com、8.8.8.8 和 44d88612fea8a8f36de82e1278abb02f。使用所有可用引擎。

可观测对象分析

• 我发现了这个（哈希|域名|URL|IP|扩展名）。你能将其提交给 Cyberbro 进行分析并分析结果吗？

OSINT 调查

• 使用 Cyberbro 为域名 example.com 创建 OSINT 报告。使用所有可用引擎，并根据结果进行关联分析以获取更多信息。最多发起 10 次分析请求。

致谢

• Model Context Protocol
• MCP Python SDK
• Cyberbro

许可证

MIT