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

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

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"
      }
    }
  }
}

一部の MCP クライアントで必要な stdio トランスポートを使って Docker を利用するには、上記の 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 レジストリへの公開用に含まれており、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