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

デフォルトのコンテナコマンドは、ポート 8000 で streamable-http モードを開始します。

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レジストリメタデータ

server.json はMCPレジストリ公開用に含まれており、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 のインジケーターを確認して。

• このIPのレピュテーションをCyberbroで確認できる？ 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