JinDaGe - mcp-ip2location-io MCP Details

article

README

🚀 IP2Location.io MCP 服务器

IP2Location.io MCP 服务器是一个简单的模型上下文协议（MCP）服务器实现，专为 IP2Location.io API 打造。它能为任意给定的 IPv4 或 IPv6 地址返回详细的地理位置信息。

✨ 主要特性

全面的地理位置数据：可获取广泛的信息，包括国家、地区、城市、纬度、经度、邮政编码、时区等。
网络详情：提供与网络相关的数据，如自治系统编号（ASN）、互联网服务提供商（ISP）、域名和网络速度。
安全洞察：检测代理信息，包括代理类型和提供商。
简单集成：作为 FastMCP 工具构建，可轻松集成到兼容系统中。
异步处理：利用 httpx 进行无阻塞的异步 API 请求。

📦 安装指南

前提条件

此 MCP 服务器支持无 API 密钥查询，但每天限制 1000 次查询。你也可以注册获取免费 API 密钥，每月最多可享受 50000 次查询。

设置过程还需使用 uv，可按照指南进行安装。

配置步骤

按照以下步骤在 Claude Desktop 中使用此 MCP 服务器：

将仓库下载到本地。
设置 uv 包管理器，你可以再次参考指南进行操作。
确保你已安装 Claude Desktop，若未安装，Windows 和 MacOS 用户可从这里下载，Linux 用户请遵循此指南进行安装。
使用你选择的编辑器打开 claude_desktop_config.json，若你还没有该文件，请遵循此指南创建。
在 claude_desktop_config.json 中添加以下内容：

{
  "mcpServers": {
    "ip2locationio": {
      "command": "uv",
      "args": [
        "--directory",
        "/path/to/ip2locationio/src",
        "run",
        "server.py"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}

记得将 /path/to/ip2locationio 替换为你本地 IP2Location.io MCP 服务器的实际路径。
要获取 API 密钥，只需登录到你的仪表盘并从中获取。将上述 <YOUR API key HERE> 替换为你实际的 API 密钥。
保存更改后重启 Claude Desktop，你应该会在“搜索和工具”菜单中看到它。

💻 使用示例

基本用法

只需在 Claude Desktop 的聊天中输入关于 IP 的查询即可。一些示例查询如下：

（IP）的位置在哪里？
（IP）位于何处？
（IP）的坐标是什么？

例如，以下是 IP 地址 8.8.8.8 的查询结果：

IP 8.8.8.8 的输出

在 Claude Desktop 中，模型将根据 IP2Location.io MCP 服务器返回的结果自动生成输出。

📚 详细文档

环境变量

IP2LOCATION_API_KEY

这是 IP2Location.io 的 API 密钥，使用该密钥每月最多可进行 50000 次查询，并获取更详细的 IP 地址信息。你可以注册获取免费 API 密钥，或订阅套餐以享受更多权益。

工具

get_geolocation

描述获取给定 IP 地址的地理位置信息。它帮助用户检索任何 IPv4 或 IPv6 地址的详细信息，如国家、地区、城市、纬度、经度、邮政编码、时区、自治系统编号（ASN）和代理信息。

参数 ip (str)：要分析的 IP 地址（IPv4 或 IPv6）。

返回值 一个包含地理位置数据的 JSON 字符串。根据你的 API 套餐，结果可能包含以下字段：

位置与地理信息：国家、地区、行政区、城市、邮政编码、纬度和经度、时区。
网络与连接信息：自治系统编号（ASN）、互联网服务提供商（ISP）、域名、网络速度、国际直拨代码（IDD）、区号、地址类型、使用类型。
移动信息：移动网络代码（MNC）、移动国家代码（MCC）、移动品牌。
货币与语言信息：货币代码、货币名称、货币符号、语言代码、语言名称。
代理与安全信息：代理类型、最后出现时间、威胁级别/类型、代理提供商、欺诈评分。
其他信息：互联网广告局（IAB）类别、天气、海拔、人口等。

如果请求失败或 IP 地址无效，该工具将返回一个错误消息字符串。

📄 许可证

请参阅 LICENSE 文件。

mcp-ip2location-io