Cyberbro MCP Server

Cyberbro 的模型上下文协议 (MCP) 服务器。

本项目打包为标准 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 传输：

docker run -i --rm \
  -e CYBERBRO_URL=http://host.docker.internal:5000 \
  ghcr.io/stanfrbd/mcp-cyberbro:latest \
  --transport 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 的示例：

{
  "mcpServers": {
    "cyberbro": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "CYBERBRO_URL",
        "ghcr.io/stanfrbd/mcp-cyberbro:latest",
        "--transport",
        "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 注册表元数据

包含用于 MCP 注册表发布的 server.json，指向 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。使用所有可用引擎。

可观测对象分析

• 我发现了这个 (hash|domain|url|ip|extension)。你能提交给 Cyberbro 进行分析并分析结果吗？

OSINT 调查

• 使用 Cyberbro 为域名 example.com 创建一份 OSINT 报告。使用所有可用引擎，并根据结果进行深入挖掘以获取更多信息。最多使用 10 个分析请求。

致谢

• Model Context Protocol

• MCP Python SDK

• Cyberbro

许可证

MIT