星战科技xingzhan.cloud
返回市场
IP搜索-MCP

IP搜索-MCP

作者：SleepingBag94530 星标更新：2025-10-28
安装使用来源：spider==github.com

项目介绍

IPSearch-MCP

离线IP Whois查询工具现支持MCP协议集成。

原始项目: https://github.com/SleepingBag945/IPSearch

原始项目原理: https://www.freebuf.com/articles/sectool/358230.html

根据关键词反向查询相关IP，收集目标资产。使用AI输入目标系统名称进行自动化IP段查找。

采用Golang编写，纯Go实现支持跨平台编译，一次编译到处运行。可以轻松集成到主控的工作流程中。

主要功能

1. IP查询（ip_lookup）

根据IPv4地址查询IP段和IPWhois信息，包括：

  • IP范围（inetnum）
  • 网络名称（netname）
  • 所属国家
  • 详细描述
  • 状态信息
  • 最后修改时间
<img width="642" alt="截屏2022-12-29 16 20 22" src="https://gips2.baidu.com/it/u=1232039010,3167327574&fm=3081&app=3101&f=PNG?w=1284&h=528">

MCP

image-20251028153550286

2. 关键词搜索（keyword-lookup）

基于IPWhois注册信息关键词搜索IP段，支持：

  • 多关键词组合查询（逗号分隔）
  • 同时匹配'descr'和'netname'字段
  • 最多返回2000条结果
<img width="648" alt="截屏2022-12-29 16 22 21" src="https://gips2.baidu.com/it/u=1057076476,3105361375&fm=3081&app=3081&f=PNG?w=1296&h=724">

MCP

image-20251028153739898

image-20251028153702023

参考提示

  - 若用户提供 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服务器，它可以集成到支持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. 下载源码编译或下载适用于您系统的IPSearch

  2. 下载IP.zip，解压并将IP.db放置在同一目录下

  3. 在Cherry Studio中配置相应的MCP服务器

    image-20251028154519149

  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协议实现