Ipsearch MCP

🚀 IPSearch-MCP

IPSearch-MCP 是一款離線 IP Whois 查詢工具，現已支持 MCP 協議集成。它可以根據關鍵詞反向查詢關聯 IP，助力用戶收集目標資產，還能借助 AI 輸入目標系統名稱自動化反查 IP 段。此工具使用 golang 編寫，純 Go 實現支持交叉編譯，能夠做到一次編譯到處運行，可方便地集成至安全從業者的工作流中。

原項目： IPSearch

原項目原理：IPSearch原項目原理

✨ 主要特性

1. IP 查詢（ip_lookup）

依據 IPv4 地址查詢所屬 IP 段以及 IPWhois 信息，具體涵蓋：

• IP 段範圍（inetnum）
• 網絡名稱（netname）
• 歸屬國家（country）
• 詳細描述（descr）
• 狀態信息（status）
• 最後修改時間（last - modified）

MCP 相關示例圖：

2. 關鍵詞查詢（keyword_lookup）

根據 IPWhois 登記信息關鍵字搜索 IP 段，具備以下特性：

• 支持多關鍵詞組合查詢（逗號分隔）
• 可同時匹配 descr 和 netname 字段
• 最多返回 2000 條結果

MCP 相關示例圖：

參考提示詞

  - 若用戶提供 IPv4 地址，請調用 ip_lookup 工具查詢 IP Whois 信息，並返回包含 IP 段、名稱、描述、國家、狀態、最後修改等字段的結果。確保在調用前對 IP 做基礎校驗，非合法 IPv4 要提示用戶重新輸入。        
  - 若用戶提供單位名稱，請先判斷所屬地區、機構類型及關鍵名詞，然後構造多組關鍵詞多次調用 keyword_lookup 工具，具體規則（禁止使用單獨的高匹配度關鍵詞，如zhejiang,這會導致返回大量結果無法處理）：                                                                                     
      - 第一次：提取單位中文名稱拼音首字母，示例：浙江第一人民醫院 → zjdyrmyy。
      - 第二次：提取單位英文分詞組合：示例：浙江第二人民醫院 → zhejiang,second,hospital                                                                                                                 
      - 第三次：提取單位中文拼音分詞組合，示例：浙江第一人民醫院 → zhejiang,diyi,yiyuan                                                                   
      - 第三次：格式為“地區英文 + 公司主要拼音”，示例：吉林混論機械股份有限公司 → jilin,kunlun
      - 第四次：格式為“地區英文 + 公司主要英文”，示例：浙江酒股份有限公司 → 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 段及完整的 IPWhois 信息。

keyword_lookup

• 參數：keywords (string, 必需) - 逗號分隔的關鍵字列表。
• 返回：匹配的 IP 段列表（最多 2000 條）。

📚 詳細文檔

依賴說明

• Go 1.23.0+
• github.com/glebarez/go - sqlite - 純 Go SQLite 驅動，支持交叉編譯。
• github.com/mark3labs/mcp - go - MCP 協議實現。