纯真IP库检索工具
hangyang/ChunZhenIPTool
1 Stars
282 次浏览
cnwhy
更新于 2026-08-23
MCP 服务配置
复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用
{
"mcpServers": {
"qqwry": {
"args": [
"-y",
"@cnwhy/qqwry-mcp"
],
"command": "npx"
}
}
}该服务需要配置环境变量：QQWRY_DATA_PATH
可用工具 （4 个）
该服务在 MCP 协议中暴露的工具，AI 可按需调用
query_ip 1 个参数 需填 1 项
通过IP检索纯真IP库,获取IP地址的归属地信息; 通过查询255.255.255.255,可以查询纯真IP库的版本信息;
必填参数：ip
query_ip_scope 2 个参数 需填 2 项
通过IP检索纯真IP库,查询IP段内的所有IP地址的归属地信息,结果以IP段的形式返回
必填参数：beginIP、endIP
get_ip_use_keyword 3 个参数 需填 2 项
通过检索纯真IP库,查询符合关键字的所有IP段
必填参数：keywords、mode
chinge_ip_data_path 1 个参数 需填 1 项
用户可以指定要切换的纯真IP库文件; 如果不指定文件路径, 则使用默认的纯真IP库文件
必填参数：dataPath
服务介绍
QQWry MCP 服务
一个基于 Model Context Protocol (MCP) 的轻量级服务，用于提供纯真(QQWry) IP 数据库的地理定位查询能力。
功能特点
- 提供符合 MCP 规范的服务接口，支持与支持 MCP 的客户端集成
- 基于
lib-qqwry实现对纯真 IP 数据库（QQWry.dat）的解析与查询 - 支持多种部署方式：命令行调用（CLI）、HTTP 服务等
- 支持 Node.js 18+ 的 ES 模块语法（type: "module"）
- 提供标准化的输入验证（Zod）和错误处理
工具列表
| 工具名称 | 描述 |
|---|---|
query_ip |
通过 IP 检索纯真 IP 库，获取 IP 地址的归属地信息；通过查询 255.255.255.255，可以查询纯真 IP 库的版本信息 |
query_ip_scope |
通过 IP 检索纯真 IP 库，查询 IP 段内的所有 IP 地址的归属地信息，结果以 IP 段的形式返回 |
get_ip_use_keyword |
通过检索纯真 IP 库，查询符合关键字的所有 IP 段 |
chinge_ip_data_path |
用户可以指定要切换的纯真 IP 库文件；如果不指定文件路径，则使用默认的纯真 IP 库文件 |
使用方法
MCP配置
{
"mcpServers": {
"qqwry": {
"command": "npx",
"args": [
"-y",
"@cnwhy/qqwry-mcp"
]
}
}
}
环境变量
QQWRY_DATA_PATH: 指定纯真 IP 数据库文件路径（可选，默认使用内置路径）PORT: HTTP 服务监听端口（可选，默认 3000）
测试示例
Stdio 测试
npm test
HTTP 测试
# 首先启动服务
npm start
# 然后在另一个终端运行测试
npm run test:http
技术栈
- Node.js >=18.0.0
- Express ^5.1.0
- @modelcontextprotocol/sdk ^1.0.0
- lib-qqwry ^1.0.0
- zod ^3.25.76
许可证
MIT
