MCP Ip2location Io

🚀 IP2Location.io MCP服务器

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

✨ 主要特性

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

📦 安装指南

此MCP服务器支持在不使用API密钥的情况下进行查询，但每天限制为1000次查询。你也可以注册获取免费的API密钥，每月最多可享受50,000次查询。

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

🚀 快速开始

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

1. 将仓库下载到本地。
2. 设置uv包管理器，可再次参考指南进行操作。
3. 确保你已安装Claude桌面版，若未安装，Windows和MacOS用户可从此处下载，Linux用户可遵循此指南进行安装。
4. 使用你选择的编辑器打开claude_desktop_config.json，若你还没有该文件，可遵循此指南创建。
5. 在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>"
      }
    }
  }
}

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

💻 使用示例

在Claude桌面版的聊天中输入关于IP的查询即可。以下是一些示例查询：

• (IP)的位置在哪里？
• (IP)位于何处？
• (IP)的坐标是多少？

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

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

🔧 技术细节

环境变量

IP2LOCATION_API_KEY

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

工具

get_geolocation

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

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

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

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

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

📄 许可证

请参阅LICENSE文件。