Immunefi MCP Server Unofficial

🚀 Immunefi漏洞賞金MCP服務器

這是一個 MCP（模型上下文協議） 服務器，它允許AI助手和其他兼容MCP的客戶端從Immunefi漏洞賞金平臺搜索、過濾和檢索數據。

🚀 快速開始

該Immunefi MCP服務器充當兼容MCP的客戶端（如AI助手）與Immunefi漏洞賞金平臺之間的橋樑。它從官方Immunefi API獲取數據，將數據緩存6小時以減少API調用次數，並提供一個結構化接口來查詢漏洞賞金計劃信息。

✨ 主要特性

• 🔍 計劃搜索：按名稱、ID、別名或標籤搜索和過濾漏洞賞金計劃。
• 💰 賞金過濾：按賞金範圍過濾計劃。
• 🐙 GitHub發現：提取計劃詳情和範圍內資產中引用的GitHub倉庫，以進行活動分析。
• 📅 近期過濾：查找在過去X天/月內或特定日期之後更新的計劃。
• 📦 資產：檢索特定計劃的範圍內資產。
• 🏷️ 標籤訪問：訪問分類信息（產品類型、生態系統、計劃類型、語言）。
• 📅 日期信息：檢索計劃的啟動和更新日期。
• 📋 KYC狀態：檢查特定計劃是否需要KYC。
• 🏆 獎勵與影響：訪問詳細的獎勵結構和影響類別。
• 📋 自省：從API列出所有可用的計劃ID和字段。

🔧 技術細節

💡 示例：需要多種工具的複雜場景

"列出在過去7天內更新了條款、獎勵在20,000美元至200,000美元之間且標籤中包含'solidity'的協議的計劃詳情中提及的GitHub倉庫。"

上述示例，gpt - oss:20b，通過使用工具 search_updated_recently、get_max_bounty、get_tags 和 search_github_repos 輕鬆解決。

架構

• 使用 mcp.server.fastmcp.FastMCP 構建。
• 通過STDIO傳輸進行通信。

🛠️ 可用工具

服務器提供了18種專門的工具，用於與Immunefi數據進行交互：

搜索與發現

• 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]) - 訪問計劃標籤（產品類型、生態系統等）。

高級過濾

• 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倉庫。

📦 安裝指南

前提條件

• Python 3.8+
• mcp 庫（模型上下文協議）

# 創建虛擬環境
python3 -m venv venv
source venv/bin/activate

# 安裝依賴項
pip install -r requirements.txt

💻 使用示例

直接執行

直接運行服務器腳本（使用STDIO傳輸，旨在由MCP客戶端啟動）：

python3 immunefi.py

📚 詳細文檔

數據來源

服務器從官方Immunefi公共API獲取數據：

• 所有賞金：https://immunefi.com/public-api/bounties.json

🤝 貢獻

歡迎貢獻！如果您有改進想法或功能請求：

1. 分叉倉庫。
2. 創建功能分支。
3. 進行更改。
4. 提交拉取請求。

🐛 問題與支持

如果您遇到任何問題或有疑問：

• 在倉庫中創建一個問題。

📄 許可證

本項目是開源的，可在MIT許可證下使用。

🙏 致謝

• Immunefi提供了使此工具成為可能的公共API。