Yogosha MCP

🚀 Yogosha MCP Server

このプロジェクトは、Yogosha Bug Bounty PlatformとModel Context Protocol (MCP) エコシステムの間にシームレスな橋渡しを提供します。すべてのYogosha APIエンドポイントをMCPツールとして公開することで、セキュリティチーム、自動化エンジニア、AIコパイロット（Claude Desktopなど）が手動でのAPI呼び出しやカスタムスクリプトを使用せずに、Yogoshaリソースとプログラム的にやり取りできるようになります。

🚀 クイックスタート

このサーバーを起動すると、Claude Desktopや他のMCPクライアントを使用して以下の操作ができます。

• すべてのプログラムをリストする: list_programs()
• 新しいアセットを作成する: create_asset(program_id, asset_data)
• 脆弱性を修正する: patch_vulnerability(program_id, vulnerability_id, patch_data)

✨ 主な機能

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

📦 インストール

必要条件

• 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クライアントとの統合に対応しています。

📚 ドキュメント

このプロジェクトが解決する問題

• 手動のAPI作業: Yogoshaの各API呼び出しにカスタムスクリプトを書く必要がなくなり、MCPツールインターフェースを使用できます。
• AIコパイロットの有効化: LLMsや自動化エージェントが直接バグバウンティプログラム、資産、レポートを管理できるようになります。
• 統一されたセキュリティ運用: MCP標準を使用して、Yogoshaを他のセキュリティツールやダッシュボードと統合できます。

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ライセンスまたはこのリポジトリで指定されたライセンスに従います。