mcpField
M
MaxMindDB

MaxMindDB

本地服务
github.com/oschwald地图与出行11 周前更新
代码仓库

关于 MaxMindDB

MaxMindDB 是本地 MCP 服务，可查询 GeoIP2、GeoLite2 和自定义 MMDB 数据库中的 IP 地理位置及网络归属。它面向使用兼容 MCP 助手的用户，支持网络搜索、数据库比较、检查和下载。

主要功能

  1. 01查询 IP 地理位置和 ASN
  2. 02搜索并汇总网络
  3. 03比较和检查数据库
  4. 04下载并更新数据库

适用场景

  1. 01查询 IP 所属国家和 ASN
  2. 02查找某 ASN 对应的网络
  3. 03检查可用数据库及构建日期

MCP 相关

向 MCP 客户端提供 IP 查询、网络搜索、数据库比较与检查，以及数据库安装和更新工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "oschwald-maxminddb": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "MAXMINDDB_MCP_DOWNLOAD_ENABLED",
        "-e",
        "MAXMINDDB_MCP_DATABASE_DIR",
        "-e",
        "MAXMINDDB_MCP_ACCOUNT_ID",
        "-e",
        "MAXMINDDB_MCP_LICENSE_KEY",
        "-e",
        "MAXMINDDB_MCP_EDITIONS",
        "ghcr.io/oschwald/maxminddb-mcp:0.2.0"
      ],
      "env": {
        "MAXMINDDB_MCP_DOWNLOAD_ENABLED": "<MAXMINDDB_MCP_DOWNLOAD_ENABLED>",
        "MAXMINDDB_MCP_DATABASE_DIR": "<MAXMINDDB_MCP_DATABASE_DIR>",
        "MAXMINDDB_MCP_ACCOUNT_ID": "<MAXMINDDB_MCP_ACCOUNT_ID>",
        "MAXMINDDB_MCP_LICENSE_KEY": "<MAXMINDDB_MCP_LICENSE_KEY>",
        "MAXMINDDB_MCP_EDITIONS": "<MAXMINDDB_MCP_EDITIONS>"
      }
    }
  }
}
启动命令docker run -i --rm -e MAXMINDDB_MCP_DOWNLOAD_ENABLED -e MAXMINDDB_MCP_DATABASE_DIR -e MAXMINDDB_MCP_ACCOUNT_ID -e MAXMINDDB_MCP_LICENSE_KEY -e MAXMINDDB_MCP_EDITIONS ghcr.io/oschwald/maxminddb-mcp:0.2.0
需要配置的环境变量
MAXMINDDB_MCP_DOWNLOAD_ENABLED
MAXMINDDB_MCP_DATABASE_DIR
MAXMINDDB_MCP_ACCOUNT_IDYour MaxMind account ID.
MAXMINDDB_MCP_LICENSE_KEY密钥A MaxMind license key with access to the selected editions.
MAXMINDDB_MCP_EDITIONSComma-separated edition IDs available to your account.

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
ocighcr.io/oschwald/maxminddb-mcp:0.2.0

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

MaxMindDB MCP 服务

License: ISC

通过 AI 助手查询 GeoIP2、GeoLite2 和自定义 MMDB 数据库中的 IP 位置与网络归属。 通过 MCP 搜索网络、比较数据库并下载新数据库。

这是一个非官方项目，未经 MaxMind Inc. 认可。有关官方产品和支持，请访问 maxmind.com。

可以尝试这样提问：

  • “使用 MaxMindDB，识别 8.8.8.8 所属的国家和自治系统。”
  • “在我的 ASN 数据库中，查找 1.0.0.0/8 内属于 AS13335 的网络。”
  • “有哪些可用的数据库？它们是什么时候构建的？”

答案来自你的数据库。IP 地理定位只是估算，并非设备的精确位置。 ASN 数据描述的是网络归属，而非使用该地址的个人身份。

所需条件

请提供现有的 .mmdb 文件，或提供有权访问所需版本的 MaxMind 账户 ID 和许可证密钥。 本项目不附带数据库和凭据。

此服务运行于你的计算机上，并且需要支持本地 MCP 服务的客户端。

安装

Claude Desktop

通过 Claude Desktop 安装并配置此服务。无需使用终端、安装 Go 或配置文件。

  1. 下载最新版 MCPB。 此单个文件包含所有受支持平台的原生构建版本。
  2. 在 Claude Desktop 中打开 Settings → Extensions → Advanced settings → Install Extension，并选择该文件。
  3. 在扩展设置中选择提供数据库的方式：
    • 下载数据库： 输入 MaxMind 账户 ID 和许可证密钥。默认版本为 GeoLite2-City 和 GeoLite2-ASN。
    • 使用现有文件： 关闭 Download and update MaxMind databases，并选择包含 .mmdb 文件的文件夹。
  4. 启用扩展并提问：“使用 MaxMindDB，列出我的数据库并查询 8.8.8.8。”

首次下载会在后台运行。如果查询尚未就绪，请让 Claude 检查数据库状态。 请在扩展设置中输入许可证密钥，不要在聊天中输入。

从 v0.2.0 或更早版本升级： 移除旧扩展，安装新版本并重新配置。 数据库文件会保留原位。请参阅升级、设置和支持的平台。

独立可执行文件

在 macOS 上，使用 Homebrew 安装：

brew install --cask oschwald/tap/maxminddb-mcp

对于其他平台，或不使用 Homebrew 的情况，请从 GitHub Releases 下载压缩包或 Linux 软件包。 请参阅独立安装设置，了解安装方法和校验和。 然后配置服务，并连接下方的客户端。

Go 开发者也可以从源代码构建。

连接客户端

选择客户端，查看分步设置说明。

客户端设置要求
ChatGPT 桌面版已安装的可执行文件和配置；仅限本地线程
Codex已安装的可执行文件；配置文件或环境设置
Claude Code通用原生插件，或已安装的可执行文件和配置
Antigravity CLI (agy)已安装的可执行文件和配置
Zed已安装的可执行文件和配置
DockerDocker 引擎，以及容器可读取的配置文件
ChatGPT 桌面版插件（实验性）Codex CLI 注册和现有服务配置；桌面 UI 未验证
Claude Cowork 插件（实验性）通用插件 ZIP；安装和设置 UI 未验证
Cursor 插件（未经验证）Docker 引擎；安装和设置 UI 未验证
Gemini CLI（旧版）继续使用 Gemini CLI；原生扩展会提示设置账号

配置

Claude Desktop 用户可以在扩展中管理设置。对于独立安装，配置指南介绍了：

  • 使用 MaxMind 凭据下载。
  • 使用现有 MMDB 文件夹或 GeoIP.conf。
  • 环境设置、配置发现和日志记录。

如果设置失败，请先查看故障排除。

工具

助手会自动发现这些工具。你可以让它查询 IP、搜索或汇总网络、比较和检查数据库，或安装和更新数据库。

工具参考介绍了参数、结果、筛选条件、分页、限制和错误。

帮助与开发

许可证

ISC。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。