IP2Location.io MCP服务器
这是一个用于IP2Location.io API的简单模型上下文协议（MCP）服务器实现。它将返回任何给定IPv4或IPv6地址的详细地理位置信息。
特性
- 综合地理定位数据：检索广泛的信息，包括国家、地区、城市、纬度、经度、邮政编码、时区等。
- 网络详细信息：提供网络相关数据，如ASN、ISP、域和网络速度。
- 安全洞察：检测代理信息，包括代理类型和提供程序。
- 简单集成：作为一个
FastMCP该工具允许轻松集成到兼容系统中。 - 异步：利用
httpx用于非阻塞异步API请求。
需求
要求 规格 此MCP服务器支持无API密钥的查询，每天查询次数限制为1000次。你也可以
注册 npx获得免费的API密钥，每月最多可享受50000次查询。 uv如果你使用云托管的MCP服务器，你只需要Claude Desktop和 ，因为服务器是远程托管的。如果要在本地运行原始MCP服务器，本地安装程序将使用，可以通过以下方式安装
指南
.
- 设置您可以通过以下任一方式在Claude Desktop中使用此MCP服务器：
- 云托管MCP服务器：如果您想直接连接到托管的IP2Location.io MCP服务器，建议使用。
本地MCP服务器
：如果您想在自己的计算机上下载并运行原始MCP服务器，请使用此选项。
- 本指南
claude_desktop_config.json对于Linux用户。 打开 您可以选择编辑器中的文件。如果你还没有，请跟随 - 本指南
claude_desktop_config.json创建一个。
{
"mcpServers": {
"ip2location": {
"command": "npx",
"args": [
"-y",
"mcp-remote@latest",
"https://mcp.ip2location.io/",
"--header",
"X-API-Key:YOUR_API_KEY"
]
}
}
}- 将以下内容添加到您的
YOUR_API_KEY: 替换 使用您的实际IP2Location.io API密钥。要获取API密钥， - 登录
Connectors到您的仪表板。
保存更改后重新启动Claude Desktop，您应该会看到MCP服务器出现在
菜单。
- 选项2：本地MCP服务器
- 如果您想使用Claude Desktop在本地运行原始MCP服务器，请按照以下步骤操作：
uv将存储库下载到本地计算机。 设置 包管理器。你可以参考 - 本指南
claude_desktop_config.json对于Linux用户。 打开 您可以选择编辑器中的文件。如果你还没有，请跟随 - 本指南
claude_desktop_config.json创建一个。
{
"mcpServers": {
"ip2locationio": {
"command": "uv",
"args": [
"--directory",
"/path/to/ip2locationio/src",
"run",
"server.py"
],
"env": {
"IP2LOCATION_API_KEY": ""
}
}
}
}- 将以下内容添加到您的
/path/to/ip2locationio: - 替换 使用本地计算机上IP2Location.io MCP服务器的实际路径。 要获取API密钥， `` 登录
- 到您的仪表板。替换
Connectors在上面的示例中使用您的实际API密钥。
保存更改后重新启动Claude Desktop，您应该会看到它出现在
菜单。
- 用法
- 只需在Claude Desktop的聊天中输入您对IP的查询。以下是一些示例查询：
- （IP）的位置在哪里？
（IP）位于何处？
（IP）的坐标是什么？
例如，以下是IP 8.8.8.8的结果： 8.8.8.8 8.8.6.6在Claude Desktop中，模型将根据IP2Location.io MCP服务器返回的结果自动生成输出。
您还可以使用IP2Location.io批量IP地理定位API来查询多个IP地址。只需输入所有IP地址，每个IP地址之间留有空格。例如\ .
\[！注意\]
IP2LOCATION_API_KEY
IP2Location.io批量IP地理定位API需要付费计划才能工作。 环境变量 IP2Location.io API密钥，允许您每月查询多达50000个IP地址和更多IP地址的详细信息。你可以 注册 免费API密钥，或
订阅
get_geolocation
享受更多福利的计划。 工具
描述
ip获取给定IP地址或一批IP地址的地理位置。它帮助用户检索任何IPv4或IPv6地址的详细信息，如国家、地区、城市、纬度、经度、邮政编码、时区、ASN和代理信息。当检测到多个IP时，它会自动将请求路由到IP2Location.io Bulk API以进行高效处理。"1.1.1.1, 2.2.2.2"参数
（str）：要分析的IP地址（IPv4或IPv6）。您可以通过将多个IP作为逗号、空格或换行符分隔的单个字符串传递来同时查询它们（例如。， ).
- 退货 包含地理位置数据的JSON字符串。如果查询多个IP，它将返回一个JSON对象，其中每个键都是映射到其各自数据的IP地址。根据您的API计划，结果可能包括以下字段：
- 位置和地理： 国家、地区、地区、城市、邮政编码、经纬度、时区。
- 网络和连接： ASN（自治系统号）、ISP（互联网服务提供商）、域、网速、IDD码、区号、地址类型、使用类型。
- 手机信息： MNC（移动网络代码）、MCC（移动国家代码）、移动品牌。
- 货币和语言： 货币代码、货币名称、货币符号、语言代码、语言名称。
- 代理和安全： 代理类型、最后出现时间、威胁级别/类型、代理提供商、欺诈评分。
其他：
IAB类别、天气、海拔、人口等。
如果单个IP请求失败或IP无效，该工具将以字符串形式返回错误消息。对于批量请求，任何单个失败的IP都将返回映射到该特定IP地址的错误对象，而不会导致整个批处理失败。
