Apifreaks Mcp Server

@apifreaks/mcp

面向 APIFreaks 的官方 Model Context Protocol (MCP) 服务。将它添加到 Claude、Cursor、Windsurf 或任何兼容 MCP 的客户端，即可让 AI 查询实时天气、WHOIS、DNS、SSL、域名可用性／信誉／域名仿冒、IP 地理位置和威胁情报、货币、大宗商品、截图、PDF、VAT/IBAN/SWIFT、电子邮件验证、一次性电子邮件检查、电话号码验证、地理编码等信息。

连接后可以询问什么？

🌦	“东京未来 7 天的天气预报是什么？我该带伞吗？”
🔒	“检查 stripe.com 的 SSL 证书——它有效吗？何时到期？”
🌍	“谁注册了 openai.com？注册时间是什么时候？WHOIS 记录最近有变化吗？”
💱	“按今天的实时汇率，将 2500 USD 换算成 EUR、GBP 和 JPY。”
🔍	“检查这 20 个域名是否可以注册。”
🛡	“paypal-login.xyz 有风险吗？它的域名信誉和信任评分如何？”
🕵	“查找仿冒品牌 paypal 的域名。”
📡	“github.com 有哪些 DNS 记录？显示完整的 MX 和 TXT 记录。”

---

目录

• 要求
• 环境变量
• 模块
• 获取 API 密钥
• 快速开始
• 集成指南
  • Claude Code
  • Codex CLI
  • Claude Desktop
  • Cursor
  • Windsurf
  • Cline
  • OpenCode
  • Gemini CLI
  • VS Code
  • Glama
• 可用工具
• 支持
• 许可证
• 隐私政策

---

要求

• Node.js v20 或更高版本
• APIFreaks API 密钥 — 免费注册

---

环境变量

变量	必需	说明
APIFREAKS_API_KEY	是	你的 APIFreaks API 密钥 — 前往 apifreaks.com 获取
ENABLE_MODULES	是	要启用的模块，以逗号分隔。不设置时只能使用 list_modules——调用它可查看模块／工具以及如何启用更多内容。参见模块。

---

模块

此服务涵盖许多 API。若在 tools/list 中列出所有 API，会占满客户端的上下文窗口，因此你可以按需启用模块。

在 MCP 客户端配置中设置 ENABLE_MODULES。只有这些模块会被注册。如果未设置或为空，则只有 list_modules 可用——调用它即可查看所有模块，以及可直接粘贴的 ENABLE_MODULES=... 行（保留现有模块，并在后面追加新模块），然后重启。

ENABLE_MODULES=ip-intelligence,whois,dns,domain,weather

连字符和下划线可以互换（user-agent 和 user_agent 都有效）。未知名称会被忽略，并记录到 stderr。

模块	工具
ip-intelligence	IP 地理位置和威胁情报（单项 + 批量）
geocoding	正向和反向地理编码
whois	域名、IP、ASN、历史记录、反向查询、批量查询
dns	实时查询、历史记录、反向查询、批量查询
scraper	静态 HTML 抓取和 JS 渲染抓取
email-validation	验证和一次性邮箱检查（单项 + 批量）
phone-validation	单项和批量电话号码验证
ssl	实时证书和完整证书链
domain	可用性、建议、批量查询、子域名、信誉、域名抢注
screenshot	截图、滚动截图、批量截图
pdf	合并、拆分、压缩、保护、生成、转换
currency	实时/历史汇率、转换器、时间序列、货币符号、限额
commodity	实时/历史价格（245+）、波动情况、时间序列、符号
financial	VAT 税率、VAT 编号、IBAN、SWIFT/BIC
zipcode	查询、半径、距离、城市/地区
weather	当前天气、预报、历史天气、空气质量、海洋、洪水、天文
geography	行政区划、国家、城市、地区、旗帜
timezone	查询和转换
user-agent	解析单个或批量 user-agent 字符串

---

获取 API 密钥

在 apifreaks.com 登录或创建免费账户。你可以在控制面板的 API Keys 下找到 API 密钥。

完整 API 文档：apifreaks.com/docs

---

快速开始

最快的连接方式——通过 Claude Code CLI：

claude mcp add apifreaks -e APIFREAKS_API_KEY=your_apikey_here -e ENABLE_MODULES=ip-intelligence,currency,whois,dns,weather -- npx -y @apifreaks/mcp

将 ip-intelligence,currency,whois,dns,weather 替换为你需要的模块。Cursor、Windsurf、Cline 等工具的配置方法请参阅下方的集成指南。

---

集成指南

Claude Code

通过终端（推荐）：

claude mcp add apifreaks -e APIFREAKS_API_KEY=your_apikey_here -e ENABLE_MODULES=ip-intelligence,currency,whois,dns,weather -- npx -y @apifreaks/mcp

通过配置文件（~/.claude/settings.json）：

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

---

Codex CLI

codex mcp add apifreaks --env APIFREAKS_API_KEY=your_apikey_here --env ENABLE_MODULES=ip-intelligence,currency,whois,dns,weather -- npx -y @apifreaks/mcp

添加服务后，启动新的 Codex 会话。

---

Claude Desktop

编辑 claude_desktop_config.json：

• macOS： ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows： %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

保存后重启 Claude Desktop。

---

Cursor

在项目根目录中创建或编辑 .cursor/mcp.json（全局配置则使用 ~/.cursor/mcp.json）：

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

也可以前往 Cursor Settings → MCP，通过 UI 添加服务。

---

Windsurf

编辑 ~/.codeium/windsurf/mcp_config.json：

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

---

Cline

打开 Cline 中的 MCP Servers 面板，点击 Configure，然后点击 Advanced MCP Settings，打开 cline_mcp_settings.json。也可以直接编辑该文件：

• macOS： ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Linux： ~/.config/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json
• Windows： %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

保存后重启 Cline。

---

OpenCode

编辑 ~/.config/opencode/config.json：

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "apifreaks": {
      "type": "local",
      "command": ["npx", "-y", "@apifreaks/mcp"],
      "environment": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

---

Gemini CLI

编辑 ~/.gemini/settings.json（项目级配置则编辑项目根目录下的 .gemini/settings.json）：

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

---

VS Code（GitHub Copilot / Continue）

在工作区中创建 .vscode/mcp.json：

{
  "servers": {
    "apifreaks": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "ENABLE_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

---

Glama

APIFreaks MCP 服务已列入 Glama。Glama 为 Claude Desktop 和其他 MCP 客户端提供一键连接和自动配置，同时定期进行安全扫描并为工具质量评分。

在 Glama 列表页面点击 Connect 并按照提示操作 — 系统会自动为你的客户端生成正确的配置。

---

可用工具

list_modules（始终可用）

用于选择启用 ENABLE_MODULES 的模块目录。如果工具列表中缺少某项功能，或要检查覆盖范围，请调用此工具。实时工具已显示在 tools/list 中；使用 needs_enable[].enable_line 获取可直接粘贴的配置行，然后重启。

---

IP 智能分析（ip-intelligence）— 4 个工具

查询任意 IP 地址的地理位置、ISP、网络和威胁数据。

工具	描述
ipgeolocation_lookup	查询 IP 或主机名的位置、ASN、公司、货币和时区
ipgeolocation_bulk_lookup	在一次请求中查询最多 50,000 个 IP 的相同地理位置数据
ip_security_lookup	查询单个 IP 的威胁评分，以及 VPN／代理／Tor／机器人／垃圾邮件／云／网关信号
ip_security_bulk_lookup	在一次请求中查询最多 50,000 个 IP 的相同威胁情报

---

地理编码（geocoding）— 2 个工具

地址 ↔ 坐标转换。

工具	描述
geocode_forward	将地址或地点名称转换为坐标
geocode_reverse	将坐标转换为街道地址

---

WHOIS（whois）— 6 个工具

域名和 IP 的所有权数据，包括历史记录。

工具	描述
whois_domain_lookup	查询域名的实时 WHOIS 记录
whois_ip_lookup	查询 IPv4 或 IPv6 地址的 WHOIS 所有权和网络数据
whois_asn_lookup	查询自治系统编号（ASN）的 WHOIS 数据
whois_domain_history	查询域名的历史 WHOIS 快照（数据可追溯至 1986 年）
whois_reverse_lookup	按所有者姓名、电子邮件、公司或关键词搜索 WHOIS 记录
whois_bulk_domain_lookup	一次查询最多 100 个域名的实时 WHOIS 数据

---

DNS（dns）— 4 个工具

查询实时 DNS 记录、历史记录和反向记录。

工具	描述
dns_lookup	查询主机名的实时 DNS 记录 — A、AAAA、MX、NS、TXT、CNAME、SOA、SPF
dns_history	查询主机名的历史 DNS 记录快照
dns_reverse	查找指向特定 DNS 记录值的所有主机名
dns_bulk_lookup	一次查询最多 100 个主机名的实时 DNS 记录

---

爬虫（scraper）— 2 个工具

从 URL 提取 HTML 或结构化字段。优先使用静态模式；仅在页面需要浏览器时才进行 JS 渲染。

工具	描述
scraper_scrape	抓取静态 HTML（可选提取／提交表单）。说明为空时返回完整页面
scraper_scrape_js	使用 JavaScript 渲染、浏览器步骤、代理以及可选的 CAPTCHA 求解进行抓取

---

电子邮件验证（email-validation）— 4 个工具

检查可投递性、语法、域名、可选的 IP 补充信息，以及一次性邮箱提供商。

工具	描述
email_validate	验证单个电子邮件地址
email_bulk_validate	在一次请求中验证最多 100 个电子邮件地址
email_disposable_check	检查单个地址是否为一次性、免费、列入垃圾邮件名单或基于角色的邮箱，以及其域名是否有邮件服务器
email_bulk_disposable_check	在一次请求中对最多 100 个地址进行一次性邮箱检查

---

电话号码验证（phone-validation）— 2 个工具

查询运营商、线路类型、位置和标准化格式。

工具	描述
phone_validate	验证单个电话号码
phone_bulk_validate	在一次请求中验证最多 100 个电话号码

---

SSL（ssl）——2 个工具

获取任意域名的实时 SSL 证书数据。

工具	说明
ssl_live_lookup	获取域名的实时 SSL 证书
ssl_live_chain_lookup	获取域名的完整 SSL 证书链

---

域名（domain）——6 个工具

检查域名可用性，支持批量查询、推荐、子域名发现、信誉评估和域名抢注搜索。

工具	说明
domain_check_availability	检查域名是否可注册
domain_check_availability_with_suggestions	检查域名可用性并获取备选域名建议
domain_subdomain_lookup	分页列出发现的域名子域名
domain_bulk_check_availability	一次检查最多 100 个域名的可用性
domain_reputation_lookup	查询域名的风险判定、信任评分、DGA、威胁情报源和电子邮件可送达性
domain_typosquatting_lookup	查找与品牌关键词或通配符模式对应的已注册拼写错误／相似域名

---

截图（screenshot）——3 个工具

截取任意网页的屏幕截图并录制滚动过程。

工具	说明
screenshot_capture	截取网页并返回图片 URL
screenshot_bulk_capture	在一个请求中截取最多 50 个网页
screenshot_capture_scrolling	录制网页滚动视频或动画 GIF

---

PDF（pdf）——20 个工具

合并、拆分、提取或删除页面，转换为图片，根据模板生成，压缩、旋转、加密／限制、解密／解除限制，以及线性化。

任务（合并、拆分、转换等）为异步操作：会返回一个 taskId。使用 pdf_task_status 查询进度。本地文件需要使用绝对路径（MCP 服务会读取磁盘）。你也可以传入已存储的 file_id。模板生成（pdf_generate、pdf_generate_bulk）为同步操作，并返回托管的 pdf_url。

已完成的任务会包含下载 URL。请将 API 密钥作为 apiKey 查询参数或 X-apiKey 标头添加。

工具	说明
pdf_merge	合并 PDF（本地路径和／或已存储的文件 ID）
pdf_split	按页码范围拆分 PDF
pdf_extract_pages	将页面提取到新的 PDF 或 ZIP 文件中
pdf_remove_pages	从 PDF 中删除页面
pdf_to_image	将页面转换为 PNG、JPG、TIFF、BMP 或 GIF
pdf_generate	使用 JSON 渲染模板并获取托管的 PDF URL
pdf_generate_bulk	根据 CSV 的每一行分别渲染一个 PDF
pdf_compress	减小 PDF 文件大小
pdf_rotate	旋转页面
pdf_encrypt	为 PDF 添加密码保护
pdf_restrict	限制打印、复制和编辑
pdf_decrypt	移除加密
pdf_unrestrict	移除权限限制
pdf_linearize	进行线性化，以实现快速网页查看
pdf_task_status	查询一个异步任务（queued / processing / completed / failed）
pdf_file_status	获取已存储文件的元数据
pdf_files	列出已存储的 PDF
pdf_file_delete	删除已存储的 PDF
pdf_upload	上传本地 PDF 并获取文件 ID
pdf_upload_binary	以原始字节上传一个大型 PDF 并获取文件 ID

---

货币（currency）— 12 个工具

提供 170 多种法定货币和 830 多种加密货币的实时及历史汇率。

工具	描述
currency_latest_rates	所有受支持货币的最新汇率
currency_historical_rates	指定过去日期的汇率
currency_latest_converter	使用实时汇率在不同货币间转换金额
currency_historical_converter	使用指定过去日期的汇率进行转换
currency_time_series	自定义日期范围内逐日汇率
currency_fluctuation	某段时期内的汇率波动指标和百分比变化
currency_geo_convert	转换为 IP 地址所属国家/地区的当地货币
currency_supported	含元数据的完整受支持货币列表
currency_symbols	货币符号与货币名称的映射
currency_symbol_info	验证货币符号并获取其完整名称
currency_historical_data_limits	每种货币的历史数据可用时间范围
currency_historical_data_limit_info	一个货币代码的历史数据可用时间范围

---

大宗商品（commodity）— 7 个工具

提供涵盖金属、能源、农业等领域的 245 多种大宗商品实时及历史价格。如果某些符号无法解析，API 会返回包含 unresolved 映射的部分结果，而不会使整个请求失败。

工具	描述
commodity_latest_rates	最新价格（按符号的更新间隔），可选择转换为报价货币
commodity_historical_rates	指定日期的历史 OHLC 价格（从 1990 年起；如果该日期没有数据，则回退到此前最近的可用日期）
commodity_fluctuation	日期范围内的起始/结束价格、绝对变化和百分比变化（无范围长度限制）
commodity_time_series	日期范围内的每日 OHLC 价格（最长 365 天；不含非交易日）
commodity_symbols	所有受支持大宗商品符号的列表及其元数据，包括每个符号的更新间隔
commodity_symbol_info	查询单个符号（更新频率、状态、单位、货币）
commodity_quotes	大宗商品定价支持的所有报价货币列表

---

金融（financial）— 9 个工具

增值税税率、增值税税号检查、IBAN 验证以及 SWIFT/BIC 查询。

工具	描述
financial_vat_rates_by_country	某个国家/地区的增值税税率，可选择按州查询
financial_vat_rates_bulk	最多查询 100 个国家/地区或州的增值税税率
financial_vat_rates_by_ip	查询根据 IP 地址识别出的国家/地区的增值税税率
financial_vat_validate	验证欧盟（VIES）或英国（HMRC）增值税税号
financial_iban_validate	验证 IBAN（格式、校验和、银行/SEPA 元数据）
financial_swift_lookup	查询 8 位或 11 位 SWIFT/BIC 代码对应的银行详情
financial_swift_finder	按国家/地区 → 银行 → 城市 → SWIFT/BIC 代码逐级查找
financial_supported_countries	VAT、IBAN 和 SWIFT API 支持的国家/地区（及增值税州）
financial_supported_country_info	检查某个国家/地区是否受 VAT、IBAN 和/或 SWIFT 支持

---

邮政编码（zipcode）— 7 个工具

提供全球邮政编码查询、半径搜索和距离计算。

工具	描述
zipcode_lookup	查询 ZIP 或邮政编码——城市、地区、国家/地区、坐标
zipcode_radius_search	查找距中心点指定半径内的所有 ZIP 编码
zipcode_distance	计算一个基准点到最多 100 个 ZIP 编码的距离
zipcode_by_city	获取某个城市的所有 ZIP/邮政编码
zipcode_bulk_lookup	一次查询最多 100 个 ZIP/邮政编码
zipcode_distance_match	查找所有距离在指定阈值内的 ZIP 编码对
zipcode_by_region	获取某个州、省或地区的所有 ZIP/邮政编码

---

天气（weather）— 9 个工具

实时天气状况、预报、历史数据、环境监测和天文信息。

工具	描述
weather_current	查询任意地点的当前天气，包括温度、湿度、风、气压和 AQI
weather_forecast	预报未来最多 16 天的天气，支持按日、按小时或按分钟提供精度
weather_historical	查询任意过去日期的历史天气（数据可追溯至 1940 年）
weather_time_series	查询自定义日期范围内的历史天气
weather_air_quality	查询实时或预报空气质量指数及污染物明细
weather_marine	查询实时海洋天气，或未来最多 16 天的海洋天气预报
weather_flood_forecast	洪水预报，包含河流流量和流量百分位数据
weather_bulk_current	在一个请求中查询最多 50 个地点的当前天气
astronomy_lookup	查询日出、日落、月相、曙暮光、黄金时刻、太阳正午、月出以及太阳和月亮的位置

---

地理（geography）— 10 个工具

国家、城市、行政单位、地区和旗帜图片。

工具	描述
geodb_admin_levels	查询一个国家的行政级别类型
geodb_admin_units	查询一个国家的州、省和其他行政单位
geodb_admin_unit_details	查询一个行政单位的详情
geodb_countries	列出国家及其 ISO 代码、首都和地区
geodb_country_details	根据 alpha-2 代码查询一个国家的完整元数据
geodb_cities	查询一个国家的城市，可按行政单位筛选
geodb_regions	列出 GeoDB 地区（非洲、美洲、亚洲、欧洲、大洋洲、极地）
geodb_subregions	列出次级地区，可按地区筛选
geodb_flags_supported	查询支持的国家和组织旗帜标识符
geodb_flag	获取国家或组织的旗帜图片

---

时区（timezone）— 2 个工具

使用任意地点标识符查询和转换时区。

工具	描述
timezone_lookup	查询地点的时区信息 — 支持 IP、城市、纬度/经度、IATA、ICAO 或 UN/LOCODE
timezone_convert	将日期和时间从一个时区转换到另一个时区

---

用户代理（user-agent）— 2 个工具

解析用户代理字符串，提取浏览器、操作系统和设备信息。

工具	描述
user_agent_parse	解析用户代理字符串 — 浏览器、设备、操作系统、引擎
user_agent_bulk_parse	在单个请求中解析最多 20,000 个用户代理字符串

---

支持

• 电子邮件： [email protected]
• 状态： status.apifreaks.com
• 问题反馈： github.com/api-freaks/apifreaks-mcp/issues

---

许可证

本项目采用 Apache License 2.0 许可。您可以根据许可证条款自由使用、修改和分发本软件。

---

隐私政策

APIFreaks 会根据其隐私政策处理您的 API 请求。有关数据收集和处理方式的详情，请参阅 apifreaks.com/privacy-policy。