3ilm-mcp

3ilm MCP サーバー

3ilm を公開する MCP サーバーです。3ilm は、完全に照合済みの Sherlock の監査コンテスト10件から収集した、スマートコントラクトの脆弱性に関する1,032件の知見をまとめた厳選ナレッジベースです。

どのバグクラスが、どの程度の報酬率で、なぜ受理されるのかを示す構造化データを必要とするAI エージェント、セキュリティ研究者、監査ツール向けに構築されています。

内容

3ilm（アラビア語で علم、「知識」）には、以下が含まれています。

• Sherlock のコンテスト10件から集めた検証済みの知見1,032件（コンテストの結果と完全に照合済み）
• 実際の受理率を含む脆弱性パターンのカテゴリ12種類（推定値ではありません）
• トリアージを通過する内容を学ぶための、カテゴリごとの受理例と却下例

ツール

ツール	説明
search_vulnerabilities	12種類すべてのカテゴリをキーワード検索します。受理率と例を含む、一致するパターンを返します。
get_pattern_details	特定のパターン1つに関する詳細な統計表を返します。合計、受理率、Sherlock 固有の注記、例が含まれます。
list_patterns	件数の多い順に、受理状況を🟢🟡🔴で示した12種類すべてのパターンを返します。

インストール

npx 3ilm-mcp

Claude / Cursor に追加する

Claude Desktop（claude_desktop_config.json に追加）：

{
  "mcpServers": {
    "3ilm": {
      "command": "npx",
      "args": ["-y", "3ilm-mcp"]
    }
  }
}

Cursor（.cursor/mcp.json に追加）：

{
  "mcpServers": {
    "3ilm": {
      "command": "npx",
      "args": ["-y", "3ilm-mcp"]
    }
  }
}

質問例

AI アシスタントに次のように尋ねます。

• 「Sherlock におけるオラクル操作の知見の受理率はどのくらいですか？」
• 「すべての脆弱性パターンと、それぞれの報酬率を見せてください」
• 「リエントランシーの脆弱性を検索してください。何パーセントが受理されますか？」
• 「受理されたフラッシュローンの知見と、却下されたものはどう違いますか？」

データソース

vulnerability-acceptance-rates.json と同じ基礎データセットを使用しています。CC0 ライセンスで、サーバー不要で直接ダウンロードできます。このファイルが、正規の公開済み再現可能なソースです。ここに記載された数値はこのファイルから転記したもので、独自に計算したものではありません。知見は実際のコンテスト結果と照合済みです。スクレイピングや推定は行っていません。正確な照合方法については、METHODOLOGY.md をご覧ください。

12種類のパターン：fee-miscalculation、dos-griefing、reentrancy、trusted-actor、overflow、staleness、rounding、access-control、oracle-manipulation、mev-slippage、liquidation、flash-loan。

bug-bounty-intelligence-mcp との関係

どちらの MCP サーバーも、同じ検証済みデータを読み込みます。違いは対象範囲です。

	3ilm-mcp（このリポジトリ）	bug-bounty-intelligence-mcp
パターン検索／受理率	無料	無料（list_vulnerability_patterns）
リポジトリ全体のコントラクトスキャン	提供なし	x402 経由で $5 USDC（scan_contract）
費用	常に無料。有料プランなし	無料ツール＋有料ツール1つ
おすすめの用途	MCP 経由でパターンデータだけを利用したい場合	自分のコントラクトの実際のスキャンも行いたい場合

受理率の確認だけが必要であれば、どちらのサーバーでも同じように利用できます。小規模で無料のみのパッケージをお求めの場合は 3ilm-mcp を、リポジトリ全体をスキャンする有料ツールも必要な場合は bug-bounty-intelligence-mcp をお使いください。

関連リンク

• HTTP API（クエリごとの支払い、Base 上の USDC）：https://wazir-x402.duckdns.org/api/vuln-search?q=oracle
• x402 Tollbooth：すべてのエンドポイントは /api/status に記載されています

ライセンス

MIT