Geolocation Mcp

io.github.7mza由 GitHub 账号 7mza 发布v0.0.1更新于 Oct 24, 2026

An MCP server that provides fast and up-to-date IP geolocation data.

已验证STDIO仅桌面位置与生活安全与监控

概览

AI 生成的概览

一个查询 IP 地理位置数据的 MCP 服务器，可为助手提供 IPv4/IPv6 地址的城市、国家、ASN、时区以及 VPN、Tor、数据中心标记。

可以做什么
查询单个公网 IPv4 或 IPv6 地址的位置与网络信息，包括城市、地区 ISO 代码、经纬度、精度半径、邮编和时区，以及国家名称、ISO 代码和欧盟/GDPR 归属、ASN 编号、ISP 或组织名称、网络 CIDR，还有数据中心、Tor 出口节点和 VPN 标记。对多个地址进行批量查询，失败的 IP 不会影响其余结果。
适用场景
适合在助手需要为日志、注册或流量数据补充地理与网络背景时使用，或用于判断某地址是否属于 VPN、Tor 出口节点或数据中心。
运行要求
以本地容器镜像形式通过 streamable HTTP 提供，通常用 Docker 或 Compose 启动，并挂载持久卷以便数据库在重启后保留。README 让客户端连接本地 HTTP 端点。从源码构建需要 SDKMAN 和 nvm。
安装前请注意
查询时会把 IP 地址发送给该服务器，其数据来自第三方来源（GeoLite2、Tor Project、X4BNet 列表），在启动时或每日刷新，结果可能不精确或过时。未声明任何身份验证，能访问所暴露端口的人都可以查询。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Geolocation Mcp，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

GeoLocation MCP Server

[Coverage]

Fast and up-to-date IP geolocation data for LLMs

Demo

[demo]

For public IPv4 / IPv6 address:

  • Flags: isDatacenter, isTorExitNode, isVPN
  • City name, region ISO code, latitude/longitude, accuracy radius, postal code, timezone
  • Country name, ISO code, EU membership/GDPR
  • ASN number, ISP/organization name, network CIDR

MCP tools

ToolDescription
getGeoLocationDatasingle IP lookup
getGeoLocationDataBulkbatch lookup, failed IPs don't block the rest

Data sources

DataSourceRefresh
City / ASNGeoLite2 via P3TERX/GeoLite.mmdbon startup if absent
Tor exit nodesTor Projectdaily
VPN / Datacenter rangesX4BNet/lists_vpndaily

Usage

shell
# named volume so DBs persist across restartsdocker run -p 8891:8080 -v geolocation_data:/home/nonroot/.geolocation-mcp 7mza/geolocation-mcp:latest

or with compose

yaml
services:  geolocation-mcp:    image: 7mza/geolocation-mcp:latest    ports:      - '8891:8080'    restart: unless-stopped    volumes:      - geolocation_data:/home/nonroot/.geolocation-mcpvolumes:  geolocation_data:    name: geolocation_data

Connect your LLM:

shell
# example for claudeclaude mcp add --transport http geolocation http://localhost:8891/mcp

Test with MCP inspector:

shell
npm i && npm run mcp# transport: streamable# url: http://localhost:8891/mcp

Build from source

Requires SDKMAN and nvm.

shell
nvm use && npm i && sdk env install

JVM:

shell
./gradlew clean ktlintFormat ktlintCheck build./gradlew bootRun

Native:

shell
./gradlew clean ktlintFormat ktlintCheck build -PgenerateMetadata./gradlew buildImagedocker run -p 8891:8080 -v geolocation_data:/home/nonroot/.geolocation-mcp 7mza/geolocation-mcp:latest

License

GeoLite2 DBs are subject to the GeoLite2 EULA.

来源：README.md，提交 bfaec94

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v0.0.1最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分