Ipsearch MCP

🚀 IPSearch-MCP

IPSearch-MCPは、オフラインでのIP Whois情報を取得するためのツールで、現在ではMCPプロトコルの統合もサポートしています。このツールを使用することで、キーワードに基づいて関連するIPを逆引きし、ターゲットの資産を収集することができます。また、AIを使用してターゲットシステム名を入力することで、自動的にIPセグメントを逆引きすることも可能です。このツールはGo言語で記述されており、完全なクロスコンパイルをサポートしているため、一度コンパイルすればどこでも動作し、ユーザーのワークフローに簡単に統合することができます。

原プロジェクト： https://github.com/SleepingBag945/IPSearch

原プロジェクトの原理：https://www.freebuf.com/articles/sectool/358230.html

✨ 主な機能

1. IPクエリ（ip_lookup）

IPv4アドレスを指定すると、そのアドレスが属するIPセグメントとIP Whois情報を取得することができます。取得できる情報は以下の通りです。

• IPセグメント範囲（inetnum）
• ネットワーク名（netname）
• 所属国（country）
• 詳細な説明（descr）
• ステータス情報（status）
• 最後の更新日時（last-modified）

MCP

2. キーワードクエリ（keyword_lookup）

IP Whois登録情報のキーワードを使用して、IPセグメントを検索することができます。以下の機能をサポートしています。

• 複数のキーワードを組み合わせたクエリ（カンマ区切り）
• descrとnetnameフィールドの同時マッチング
• 最大2000件の結果を返す

MCP

参考提示詞

  - ユーザーがIPv4アドレスを提供した場合、ip_lookupツールを使用してIP Whois情報を取得し、IPセグメント、名前、説明、国、ステータス、最後の更新などのフィールドを含む結果を返します。呼び出し前にIPの基本的な検証を行い、有効なIPv4でない場合はユーザーに再入力を促します。        
  - ユーザーが組織名を提供した場合、まず所属地域、組織タイプ、およびキーワードを判断し、次に複数のキーワードセットを構築してkeyword_lookupツールを複数回呼び出します。具体的なルールは以下の通りです（高いマッチ率の単一のキーワード、例えばzhejiangを使用しないでください。これは大量の結果を返し、処理できなくなる可能性があります）：                                                                                     
      - 最初に、組織の中国語名の頭文字を抽出します。例：浙江第一人民医院 → zjdyrmyy。
      - 2回目に、組織の英語の単語を組み合わせます。例：浙江第二人民医院 → zhejiang,second,hospital                                                                                                                 
      - 3回目に、組織の中国語のピンインの単語を組み合わせます。例：浙江第一人民医院 → zhejiang,diyi,yiyuan                                                                   
      - 3回目に、「地域の英語 + 会社の主なピンイン」の形式にします。例：吉林混论机械股份有限公司 → jilin,kunlun
      - 4回目に、「地域の英語 + 会社の主な英語」の形式にします。例：浙江酒股份有限公司 → zhejiang,wine,ltd  
  - 上記のキーワードセットを順番に試してみます。前のキーワードセットが結果を返した場合でも、すべてのルールを実行する必要があります。各検索のキーワード文字列から余分な空白を削除し、必要に応じて複数のキーワードを組み合わせてクエリを実行します（例：zhejiang,hospital,firstとzhejiang,hospital,zjdyrmyy）。       
  - 検索結果を返す際に、IPセグメントをCIDR形式に変換し、IPセグメントがその会社に属する理由を提供します。
    - 例：
      1. 111.111.111.0/24 | IPセグメントの説明/名前の原文 | 中国語の翻訳
      2. 111.111.222.0/24 | IPセグメントの説明/名前の原文 | 中国語の翻訳の理由

🔧 技術詳細

• MCPプロトコルサポート：MCP Serverとして動作し、MCPをサポートするAIクライアントに統合できます。
• 純粋なGo実装：github.com/glebarez/go-sqlite ドライバを使用し、完全なクロスコンパイルをサポートします。
• オフラインデータベース：SQLiteベースのIP.dbデータベースを使用し、ネットワーク接続を必要としません。
• 高性能クエリ：最適化されたSQLクエリとインデックス設計により、高速なクエリを実現します。

IP.dbはSQLite形式のIPデータベースで、このツールが要件を満たさない場合は、このライブラリを使用して独自に実装することができます。

📦 インストール

コンパイル

# コードをクローンする
git clone <repository-url>
cd IPSearch

# 現在のプラットフォームをコンパイルする
go build -o IPSearch

# クロスコンパイルの例
# Linux AMD64
GOOS=linux GOARCH=amd64 go build -o IPSearch-linux-amd64

# macOS AMD64
GOOS=darwin GOARCH=amd64 go build -o IPSearch-darwin-amd64

# macOS ARM64 (M1/M2)
GOOS=darwin GOARCH=arm64 go build -o IPSearch-darwin-arm64

# Windows AMD64
GOOS=windows GOARCH=amd64 go build -o IPSearch-windows-amd64.exe

実行

1. ソースコードをダウンロードしてコンパイルするか、Releaseから自分のシステムに適したIPSearchをダウンロードします。
2. IP.zipをダウンロードし、解凍してIP.dbをIPSearchと同じディレクトリに配置します。
3. cherrystudioで対応するMCPサーバーを設定します。

4. ツールは標準入出力を介してMCPクライアントと通信します。

MCPツールの説明

ip_lookup

• パラメータ：ip (string, 必須) - クエリ対象のIPv4アドレス
• 戻り値：IPセグメントと完全なIP Whois情報

keyword_lookup

• パラメータ：keywords (string, 必須) - カンマ区切りのキーワードリスト
• 戻り値：一致するIPセグメントのリスト（最大2000件）

📚 依存関係

• Go 1.23.0以降
• github.com/glebarez/go-sqlite - 純粋なGo SQLiteドライバで、クロスコンパイルをサポートします。
• github.com/mark3labs/mcp-go - MCPプロトコルの実装