Immunefi MCP Server Unofficial

🚀 Immunefi Bug Bounty MCP Server

MCP (Model Context Protocol)サーバーです。このサーバーを使用すると、AIアシスタントやその他のMCP互換クライアントが、Immunefiバグバウンティプラットフォームからデータを検索、フィルタリング、取得することができます。

🚀 クイックスタート

Immunefi MCPサーバーは、MCP互換クライアント（AIアシスタントなど）とImmunefiバグバウンティプラットフォームの間の橋渡しとして機能します。公式のImmunefi APIからデータを取得し、API呼び出しを減らすために6時間キャッシュし、バグバウンティプログラム情報を照会するための構造化されたインターフェイスを公開します。

✨ 主な機能

• 🔍 プログラム検索：名前、ID、スラッグ、またはタグでバグバウンティプログラムを検索およびフィルタリングする
• 💰 バウンティフィルター：バウンティ範囲でプログラムをフィルタリングする
• 🐙 GitHubディスカバリー：プログラムの詳細と対象資産に記載されているGitHubリポジトリを抽出し、アクティビティ分析を行う
• 📅 最近更新フィルター：過去X日/月以内または特定の日付以降に更新されたプログラムを検索する
• 📦 資産：特定のプログラムの対象資産を取得する
• 🏷️ タグアクセス：カテゴライズされた情報（productType、ecosystem、programType、language）にアクセスする
• 📅 日付情報：プログラムの起動日と更新日を取得する
• 📋 KYCステータス：特定のプログラムでKYCが必要かどうかを確認する
• 🏆 報酬と影響：詳細な報酬構造と影響カテゴリにアクセスする
• 📋 イントロスペクション：APIから利用可能なすべてのプログラムIDとフィールドをリストする

🔧 技術詳細

アーキテクチャ

• mcp.server.fastmcp.FastMCPで構築されています。
• STDIOトランスポートを介して通信します。

コンパレックスなシナリオの例

"過去7日間に利用規約を更新し、報酬が**$20,000から$200,000の間で、タグにsolidityが含まれるプロトコルのプログラム詳細に記載されているGitHubリポジトリ**をリストアップする。"

上記の例では、gpt - oss:20bがsearch_updated_recently、get_max_bounty、get_tags、search_github_reposというツールを使用して簡単に解決します。

📦 インストール

前提条件

• Python 3.8以上
• mcpライブラリ（Model Context Protocol）

# 仮想環境を作成する
python3 -m venv venv
source venv/bin/activate

# 依存関係をインストールする
pip install -r requirements.txt

💻 使用例

基本的な使用法

サーバーを直接実行する（STDIOトランスポートを使用し、MCPクライアントによって起動されることを想定）:

python3 immunefi.py

🛠️ 利用可能なツール

サーバーは、Immunefiデータとやり取りするための18の専用ツールを提供します。

検索とディスカバリー

• search_program(query: str) - 名前、ID、スラッグ、またはタグでプログラムを検索する
• get_all_project_ids() - 利用可能なすべてのプロジェクトIDを取得する
• get_available_fields() - 利用可能なすべてのデータフィールドをリストする

プログラムデータアクセス

• get_program_assets(project_ids: List[str]) - 対象資産を取得する
• get_max_bounty(project_ids: List[str]) - 最大バウンティ額を取得する
• get_launch_date(project_ids: List[str]) - プログラムの起動日を取得する
• get_updated_date(project_ids: List[str]) - 最後の更新日を取得する
• is_kyc_required(project_ids: List[str]) - KYC要件を確認する
• get_rewards(project_ids: List[str]) - 報酬構造にアクセスする
• get_impacts(project_ids: List[str]) - 影響カテゴリと説明を取得する
• get_tags(project_ids: List[str]) - プログラムのタグ（productType、ecosystemなど）にアクセスする

高度なフィルタリング

• filter_by_bounty(min_bounty: int = 0, max_bounty: Optional[int] = None, project_ids: Optional[List[str]] = None) - バウンティ範囲でフィルタリングする
• filter_by_language(project_ids: List[str], language: str) - 言語タグでプログラムをフィルタリングする
• filter_by_ecosystem(project_ids: List[str], ecosystem: str) - エコシステムタグでプログラムをフィルタリングする
• search_updated_recently(days: Optional[int] = None, months: Optional[int] = None, project_ids: Optional[List[str]] = None) - 最近更新されたプログラムを検索する
• search_updated_after_date(date: str, project_ids: Optional[List[str]] = None) - 特定の日付以降に更新されたプログラムを検索する
• get_field_values(project_ids: List[str], field_name: str) - 特定のフィールド値を取得する

コードディスカバリー

• search_github_repos(project_ids: List[str]) - プログラムデータからGitHubリポジトリを抽出する

📊 データソース

サーバーは、公式のImmunefi公開APIからデータを取得します。

• すべてのバウンティ: https://immunefi.com/public-api/bounties.json

🤝 コントリビューション

コントリビューションは大歓迎です！改善案や機能リクエストがある場合は、以下の手順に従ってください。

1. リポジトリをフォークする
2. 機能ブランチを作成する
3. 変更を加える
4. プルリクエストを送信する

🐛 問題とサポート

問題が発生した場合や質問がある場合は、リポジトリにイシューを登録してください。

📄 ライセンス

このプロジェクトはオープンソースであり、MITライセンスの下で利用可能です。

🙏 謝辞

• このツールを可能にした公開APIを提供してくれたImmunefiに感謝します。