HackMyIP — no-key IP intelligence

hackmyip-mcp

无需密钥的 IP 情报 MCP——粘贴一个 URL，无需注册。

https://hackmyip.com/mcp

全部设置就是这么简单。无需 API 密钥。无需账号。无需繁琐的 OAuth 流程。无需信用卡。将任意 MCP 客户端指向该 URL，你的 Agent 就能立即查询 IP、对地址进行地理定位、 识别 VPN／数据中心流量、查询 DNS、运行 WHOIS、检查垃圾邮件黑名单、审计 安全标头、扫描端口并测试电子邮件身份验证。

这是一个轻量、无状态的封装，基于免费的 HackMyIP 公共 REST API（文档），运行在边缘的 Cloudflare Workers 上。每个工具都会将 API 的 JSON 原样返回给你的 Agent——不会缓存、 改写或编造任何内容。

安装

Claude Code

claude mcp add --transport http hackmyip https://hackmyip.com/mcp

Claude Desktop

设置 → 连接器 → 添加自定义连接器，然后粘贴：

https://hackmyip.com/mcp

{
  "mcpServers": {
    "hackmyip": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://hackmyip.com/mcp"]
    }
  }
}

Cursor

~/.cursor/mcp.json（全局）或 .cursor/mcp.json（按项目）：

{
  "mcpServers": {
    "hackmyip": {
      "url": "https://hackmyip.com/mcp"
    }
  }
}

Codex CLI

~/.codex/config.toml：

[mcp_servers.hackmyip]
url = "https://hackmyip.com/mcp"

重启 Codex。无需执行 codex mcp login——此服务无需身份验证。

VS Code / GitHub Copilot

.vscode/mcp.json：

{
  "servers": {
    "hackmyip": {
      "type": "http",
      "url": "https://hackmyip.com/mcp"
    }
  }
}

其他客户端

任何支持 MCP Streamable HTTP 的客户端都可以使用。端点： https://hackmyip.com/mcp（镜像：https://hackmyip-mcp.shitcoinape.workers.dev/mcp）。 支持 2025-06-18 和 2026-07-28 两个协议修订版本。

工具

值得了解的事项

• my_ip 报告 MCP 请求到达时的来源 IP。 如果客户端运行在你的 笔记本电脑上，这就是你的真实公网 IP——因此可以回答“我的 VPN 到底有没有 正常工作？”如果客户端运行在远程主机上，或处于企业代理之后，报告的则是 对应的出口 IP。工具会在响应中说明这一点。
• ip_blacklist_check 不会伪造干净结果。 拒绝公开查询的名单会返回 unavailable，因此请同时查看 total_checked 和 listed_count。
• port_scan 是从 Cloudflare 网络发起的真实扫描。 仅扫描你获准测试的 主机。上游会拒绝私有和保留地址段。
• whois_domain 依赖第三方 RDAP 注册机构，它们偶尔会返回 5xx 错误。此类 故障来自上游，并非查询格式错误——请重试。

合理使用

上游 API 对每个客户端 IP 的限制为 60 次请求/分钟（port_scan 和 security_headers_check 为 20 次/分钟），每 60 秒重置一次。没有付费套餐可供升级， 也没有可以解除限制的密钥——此限制旨在让所有人都能免费使用该服务。如果达到限制， 工具会返回上游的 429 消息，此时应暂停请求。

与循环调用 ip_lookup 相比，优先使用 bulk_ip_lookup。

隐私

此服务不存储任何内容。它不保留会话状态，不记录你的查询日志，也不要求提供身份信息。 每次工具调用都是对 https://hackmyip.com/api/* 的无状态直通请求。

自行运行

git clone https://github.com/0xvibly/hackmyip-mcp
cd hackmyip-mcp
npm install
npm run dev          # local dev server at http://localhost:8787/mcp
npm run deploy       # deploy to your own Cloudflare account

基于 @modelcontextprotocol/server 和 Cloudflare 的 agents createMcpHandler 构建—— 无状态，不使用 Durable Objects，也不使用数据库。

链接

• 网站 — https://hackmyip.com
• API 文档 — https://hackmyip.com/api-docs
• 50 多种浏览器工具（VPN 泄漏测试、指纹识别、泄露检查）— https://hackmyip.com/tools

许可证

MIT