快速接入

先看主来源和安装命令，再打开仓库或文档；下面只保留这个条目的关键接入事实。

详细介绍

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: web服务监听端口（可选，默认 3000，使用web服务模式时有效）

测试示例

Stdio 测试

npm test

HTTP 测试

# 首先启动服务
npm start

# 然后在另一个终端运行测试
npm run test:http

技术栈

>=18.0.0
Express ^5.1.0
@modelcontextprotocol/sdk ^1.0.0
lib-qqwry ^1.0.0
zod ^3.25.76

许可证

MIT

目录标签

JavaScript位置天气本地部署IP查询地理定位MCP协议纯真IP库Node.js

接入字段

传输方式（transport，传输协议）

未说明

鉴权方式（authType，认证方式）

none

工具数量（toolCount，工具数）

0

资源数量（resourceCount，资源数）

0

提示词数量（promptCount，提示词数）

0

权限和风险

未说明none部署方式未说明

接入前请确认传输方式、认证方式和部署位置，并根据实际工具能力限制访问范围。

安装前确认

不要直接授予不必要的文件、网络或账号权限；先核对安装命令和配置内容。

仍需确认：installCommand

来源信息

MCP World

mcpworld.com

/detail/4fbdab2d3e6bec877cfbc9c9fb822885

一个基于Model Context Protocol (MCP)的轻量级服务，提供纯真(QQWry) IP数据库的地理定位查询能力，支持多种部署方式和标准化输入验证。

继续浏览同类 MCP

更多AI代理 MCP（18,706）返回 MCP 目录

上一个 MCP

Qq Bot MCP

通过MCP工具协议暴露QQ消息收发能力，让外部项目无需依赖QQ SDK即可接入QQ消息流。

下一个 MCP

Qradar MCP Server

QRadar MCP Server是一款通过自然语言处理技术，让AI代理调查安全事件、查询违规行为、运行AQL搜索和管理威胁情报的服务。

Qqwry MCP