Yogosha Mcp

Yogosha MCP サーバー

概要

このプロジェクトは、Yogosha Bug Bounty Platform と Model Context Protocol（MCP）エコシステムをシームレスにつなぎます。すべての Yogosha API エンドポイントを MCP ツールとして公開することで、セキュリティチーム、自動化エンジニア、AI コパイロット（Claude Desktop など）が、手動で API を呼び出したり、独自のスクリプトを作成したりすることなく、Yogosha のリソースをプログラムから操作できるようにします。

効果

• 自動化： 自然言語やワークフローツールを使って、脆弱性管理、アセットインベントリ、レポート作成などを即座に自動化できます。
• 統合： Yogosha を MCP 互換のエージェント、LLM、ワークフローオーケストレーター（Claude Desktop、カスタムボットなど）に接続できます。
• セキュリティ： 環境変数による API キー管理を徹底し、コードにシークレットを含めません。すべての操作はステートレスで、監査可能です。
• 拡張性： server.py を拡張するだけで、新しいエンドポイントや独自のロジックを追加できます。コアインフラストラクチャを変更する必要はありません。
• 生産性： 脆弱性やアセットのトリアージ、更新、レポート作成にかかる時間を大幅に短縮できます。

どのような問題を解決しますか？

• 手動での API 操作： Yogosha API を呼び出すたびに独自のスクリプトを書く必要はありません。MCP ツールインターフェースを使うだけです。
• AI コパイロットの活用： LLM や自動化エージェントを使って、バグバウンティプログラム、アセット、レポートを直接管理できます。
• セキュリティ運用の統合： MCP 標準を使って、Yogosha を他のセキュリティツールやダッシュボードと統合できます。

必要条件

• Python 3.8+
• uv（Python パッケージを高速に管理・実行するため）
• Yogosha API キー

セットアップ

1. 依存関係をインストールします：

   uv pip install -r requirements.txt
   

2. Yogosha API キーを設定します：

   export YOGOSHA_API_KEY=your_yogosha_api_key_here
   

3. MCP サーバーを実行します：

   uv run server.py
   

   サーバーはデフォルトで stdio トランスポートを使用し、Claude Desktop やその他の MCP クライアントと連携します。

クイックスタートの例

起動後、Claude Desktop または任意の MCP クライアントを使って、次の操作を実行できます。

• すべてのプログラムを一覧表示する：list_programs()
• 新しいアセットを作成する：create_asset(program_id, asset_data)
• 脆弱性にパッチを適用する：patch_vulnerability(program_id, vulnerability_id, patch_data)

Claude Desktop の MCP サーバー設定

このサーバーを Claude Desktop で使用するには、次の内容を mcpserver.json に追加します。

{
  "mcpServers": {
    "YogoshaMCP": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/haji/mcp-servers/yogosha-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

• プロジェクトの場所が異なる場合は、--directory のパスを調整してください。
• サーバーは Claude Desktop で「YogoshaMCP」として利用できます。

セキュリティ

• API キーは YOGOSHA_API_KEY 環境変数から読み込まれます。API キーをソース管理にコミットしないでください。
• すべてのコードはステートレスで、MCP ツールとして安全に使用できるよう設計されています。

拡張

• エンドポイントを追加するには、server.py の関数パターンに従ってください。

ライセンス

MIT、またはこのリポジトリで指定されているライセンスです。