mcp-server-iplocate - 集成IPLocate.io，提供IP多维度数据查询的MCP工具

探索

MCP Server Iplocate

IPLocate.io的MCP服务器，提供IP地址的地理位置、网络信息、隐私检测和滥用联系人等全面数据查询服务。

位置服务安全 #IP查询 #地理位置 #网络安全 #网络分析 .TypeScript

评分 : 2.5分

下载量 : 9

更新时间 : 2025-07-25

安装

复制以下命令到你的Client进行配置

{
     "mcpServers": {
       "iplocate": {
         "command": "npx",
         "args": ["-y", "@iplocate/mcp-server"],
         "env": {
           "IPLOCATE_API_KEY": "your_api_key_here"
         }
       }
     }
   }

注意：您的密钥属于敏感信息，请勿与任何人分享。

🚀 IPLocate.io IP地址地理定位及网络数据MCP服务器

本项目是一个用于 IPLocate.io 的MCP（模型上下文协议）服务器，能提供全面的IP地址情报，包括地理定位、网络信息、隐私检测和滥用联系人信息等，助力用户深入了解IP地址相关情况。

🚀 快速开始

使用此MCP服务器最简单的方法是通过您的MCP客户端。只需按照以下设置说明配置您的客户端：

配置您的MCP客户端

Cursor

一键设置：

手动配置：

在您的项目目录中创建配置文件：
```
mkdir -p .cursor
touch .cursor/mcp.json
```

将以下内容添加到 .cursor/mcp.json 中：

{
  "mcpServers": {
    "iplocate": {
      "command": "npx",
      "args": ["-y", "@iplocate/mcp-server"],
      "env": {
        "IPLOCATE_API_KEY": "your_api_key_here"
      }
    }
  }
}

请将 your_api_key_here 替换为您从 IPLocate.io 获取的实际API密钥。

Claude Desktop

打开Claude Desktop设置
- 在macOS上：按 Cmd + ,
- 在Windows上：按 Ctrl + ,
转到“开发者”选项卡，然后点击“编辑配置”

添加IPLocate服务器配置：

{
  "mcpServers": {
    "iplocate": {
      "command": "npx",
      "args": ["-y", "@iplocate/mcp-server"],
      "env": {
        "IPLOCATE_API_KEY": "your_api_key_here"
      }
    }
  }
}

请将 your_api_key_here 替换为您从 IPLocate.io 获取的实际API密钥。

VS Code（预览版）

创建VS Code MCP配置文件：

mkdir -p .vscode
touch .vscode/mcp.json

将以下内容添加到 .vscode/mcp.json 中：

{
  "servers": {
    "iplocate": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@iplocate/mcp-server"],
      "env": {
        "IPLOCATE_API_KEY": "your_api_key_here"
      }
    }
  }
}

请将 your_api_key_here 替换为您从 IPLocate.io 获取的实际API密钥。

可用工具

服务器提供以下工具：

`lookup_ip_address_details`

获取有关IP地址的全面信息，包括所有可用数据。

参数：

ip（可选）：要查询的IPv4或IPv6地址。如果未提供，则返回调用者IP地址的信息。

示例：

{
  "ip": "8.8.8.8"
}

返回： 有关IP地址的所有可用数据，包括地理位置、网络信息、隐私和公司数据。

`lookup_ip_address_location`

获取IP地址的地理位置信息。

参数：

ip（可选）：要查询的IPv4或IPv6地址。

返回： 国家、城市、坐标、时区、邮政编码等。

`lookup_ip_address_privacy`

检查IP地址是否被检测为VPN、代理、其他匿名服务；是否在滥用黑名单中；或者是否为托管服务提供商。

参数：

ip（可选）：要查询的IPv4或IPv6地址。

返回： VPN状态、代理检测、Tor出口节点状态、托管服务提供商信息。

`lookup_ip_address_network`

获取IP地址的网络和ASN（自治系统编号）信息。

参数：

ip（可选）：要查询的IPv4或IPv6地址。

返回： ASN详细信息、网络范围、ISP信息、区域注册表。

`lookup_ip_address_company`

获取IP地址的公司/组织信息。

参数：

ip（可选）：要查询的IPv4或IPv6地址。

返回： 公司名称、域名、国家、组织类型。

`lookup_ip_address_abuse_contacts`

获取IP地址的滥用联系人信息，用于报告恶意活动。

参数：

ip（可选）：要查询的IPv4或IPv6地址。

返回： 滥用联系人电子邮件、电话、地址和网络范围。

可用提示

服务器还提供预配置的提示，以帮助进行常见的IP分析任务：

`check_ip_security`

分析IP地址的安全问题，包括VPN、代理、Tor使用和滥用历史。

示例用法： "使用 check_ip_security 提示分析192.168.1.1"

`locate_ip_geographically`

获取有关IP地址的详细地理信息。

示例用法： "使用 locate_ip_geographically 提示查找我的位置"

`investigate_ip_ownership`

获取有关谁拥有和运营IP地址的详细信息。

示例用法： "使用 investigate_ip_ownership 提示检查谁拥有8.8.8.8"

`ip_comparison`

比较两个IP地址之间的地理和网络信息。

示例用法： "使用 ip_comparison 提示比较1.1.1.1和8.8.8.8"

✨ 主要特性

此MCP服务器提供了查询IP地址详细信息的工具：

地理位置：国家、城市、坐标、时区、邮政编码等
网络信息：ASN名称、编号、类型、网络范围、ISP信息
隐私与安全：VPN检测、代理检测、Tor出口节点、托管服务提供商
公司数据：组织名称、域名、业务类型
滥用联系人：用于报告恶意活动的电子邮件、电话和地址

📦 安装指南

要遵循我们的快速启动设置说明，您需要：

Node.js 18或更高版本
npm
兼容的MCP客户端。例如，Cursor、Claude Desktop。

手动运行服务器

如果您需要手动运行服务器（用于开发或测试），您有以下几种选择：

前提条件

Node.js 18或更高版本
npm或yarn

使用npx（推荐）

npx -y @iplocate/mcp-server

使用API密钥：

在macOS/Linux上：

export IPLOCATE_API_KEY=your_api_key_here
npx -y @iplocate/mcp-server

在Windows上：

set IPLOCATE_API_KEY=your_api_key_here
npx -y @iplocate/mcp-server

从npm安装

npm install -g @iplocate/mcp-server
mcp-server-iplocate

从源代码安装

git clone https://github.com/iplocate/mcp-server-iplocate.git
cd mcp-server-iplocate
yarn install
yarn build
yarn start

用于开发并自动重新加载：

yarn dev

测试

您可以使用 MCP Inspector 测试服务器：

npx @modelcontextprotocol/inspector node dist/index.js

📚 详细文档

添加您的API密钥

在没有API密钥的情况下，您每天最多可以进行50次请求。在 IPLocate.io 上注册免费API密钥，可将您的免费配额提高到 每天1000次请求。

注册免费API密钥

访问 https://iplocate.io/signup
创建免费账户
从仪表板获取您的API密钥

在本服务器中使用API密钥

服务器会自动从 IPLOCATE_API_KEY 环境变量中读取您的API密钥。您可以在MCP客户端设置中进行配置（请参阅上面的配置示例），或者在手动运行时进行设置。

API响应格式

IPLocate API返回有关IP地址的全面数据。以下是一个示例响应结构：

{
  "ip": "8.8.8.8",
  "country": "United States",
  "country_code": "US",
  "city": "Mountain View",
  "latitude": 37.386,
  "longitude": -122.0838,
  "asn": {
    "asn": "AS15169",
    "name": "Google LLC",
    "domain": "google.com"
  },
  "privacy": {
    "is_vpn": false,
    "is_proxy": false,
    "is_tor": false,
    "is_hosting": true
  }
  // ... 还有更多字段
}