IP2Location.io MCP 服务器

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

<a href="https://glama.ai/mcp/servers/@ip2location/mcp-ip2location-io"> <img width="380" height="200" src="https://gips1.baidu.com/it/u=443164244,3199938099&fm=3081&app=33081&f=PNG?w=760&h=400" /> </a>

功能

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

要求

此MCP服务器支持无需API密钥查询，每日限制1,000次查询。您也可以注册免费API密钥，并享受每月高达50,000次查询。

设置还使用了uv，可以通过指南安装。

设置

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

1. 将仓库下载到本地。
2. 设置uv包管理器，您可以再次参考指南来完成。
3. 确保已安装Claude Desktop，如果没有，请从这里下载适用于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 Desktop，您应该能在“搜索和工具”菜单中看到它。

使用方法

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

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

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

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

环境变量

IP2LOCATION_API_KEY

IP2Location.io API密钥，允许您每月查询多达50,000次，并获得更详细的IP地址信息。您可以注册免费API密钥，或订阅计划以享受更多好处。

工具

get_geolocation

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

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

返回值 包含地理位置数据的JSON字符串。结果可能包括以下字段，具体取决于您的API计划：

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

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

许可证

参见LICENSE文件。