Skip to main content
Glama

@apifreaks/mcp

npm version GitHub release Glama Node.js CI License

APIFreaks 的官方 Model Context Protocol (MCP) 服务器。将其添加到 Claude、Cursor、Windsurf 或任何兼容 MCP 的客户端,您的 AI 即可即时查询实时天气、域名、IP、DNS 记录、SSL 证书、货币汇率、大宗商品价格、截图、PDF、网页抓取、VAT/IBAN/SWIFT、邮箱和电话验证、地理编码等。

连接后可以问什么?

🌦

"东京未来 7 天的天气预报如何?我需要带伞吗?"

🔒

"检查 stripe.com 的 SSL 证书——它有效吗?什么时候过期?"

🌍

"谁注册了 openai.com?什么时候注册的?WHOIS 记录最近有变化吗?"

💱

"按今日实时汇率将 2500 美元兑换为欧元、英镑和日元。"

🔍

"检查这 20 个域名是否可以注册。"

📡

"github.com 有哪些 DNS 记录?请显示完整的 MX 和 TXT 记录。"


目录


Related MCP server: Weather MCP Server

环境要求


环境变量

变量

必需

描述

APIFREAKS_API_KEY

您的 APIFreaks API 密钥——在 apifreaks.com 获取

APIFREAKS_MODULES

要暴露的模块列表,以逗号分隔。如果未设置或为空,则仅列出 list_modules(无 API 工具)。参见模块


模块

此服务器涵盖许多 API。在 tools/list 中全部列出会占满客户端的上下文窗口,因此您可以按需选择实际需要的模块。

在 MCP 客户端配置中设置 APIFREAKS_MODULES。只有这些模块会被注册,因此 tools/list 仅返回该子集。如果该变量缺失或为空,则不会列出任何 API 工具——仅列出 list_modules。调用它可查看每个模块及其包含的工具,然后粘贴完整的 APIFREAKS_MODULES=... 行(包含您需要的所有模块,而不仅仅是新名称)并重启。

APIFREAKS_MODULES=ip-intelligence,currency,whois,dns,weather

连字符和下划线可以互换(user-agentuser_agent 均有效)。未知名称会被忽略并记录到 stderr。

模块

工具

ip-intelligence

IP 地理定位和威胁情报(单个 + 批量)

geocoding

正向和反向地理编码

whois

域名、IP、ASN、历史、反向、批量

dns

实时查询、历史、反向、批量

scraper

静态 HTML 抓取和 JS 渲染抓取

email-validation

单个和批量邮箱验证

phone-validation

单个和批量电话验证

ssl

实时证书和完整证书链

domain

可用性检查、建议、批量、子域名查询

screenshot

截图、滚动截图、批量

pdf

合并、拆分、压缩、保护、生成、转换

currency

实时/历史汇率、转换器、时间序列、符号、限额

commodity

实时/历史价格、波动、时间序列、符号

financial

VAT 税率、VAT 编号、IBAN、SWIFT/BIC

zipcode

查询、半径、距离、城市/地区

weather

当前、预报、历史、空气质量、海洋、洪水、天文

geography

行政区划、国家、城市、地区、旗帜

timezone

查询和转换

user-agent

解析单个或批量 user-agent 字符串


获取 API 密钥

apifreaks.com 登录或创建免费账户。您的 API 密钥位于仪表盘的 API Keys 下。

完整 API 文档:apifreaks.com/docs


快速开始

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

claude mcp add apifreaks -e APIFREAKS_API_KEY=your_apikey_here -e APIFREAKS_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 APIFREAKS_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",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

Codex CLI

codex mcp add apifreaks --env APIFREAKS_API_KEY=your_apikey_here --env APIFREAKS_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",
        "APIFREAKS_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",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

或者前往 Cursor Settings → MCP,通过界面添加服务器。


Windsurf

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

{
  "mcpServers": {
    "apifreaks": {
      "command": "npx",
      "args": ["-y", "@apifreaks/mcp"],
      "env": {
        "APIFREAKS_API_KEY": "your_apikey_here",
        "APIFREAKS_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",
        "APIFREAKS_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",
        "APIFREAKS_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",
        "APIFREAKS_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",
        "APIFREAKS_MODULES": "ip-intelligence,currency,whois,dns,weather"
      }
    }
  }
}

Glama

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

点击 Glama 列表页面上的 Connect 并按照提示操作——它将自动为您的客户端生成正确的配置。


可用工具

IP 情报(ip-intelligence)— 4 个工具

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

工具

描述

ipgeolocation_lookup

IP、IPv6 地址或主机名的地理位置数据

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)— 2 个工具

可投递性、语法、域名及可选的 IP 富化。

工具

描述

email_validate

验证单个电子邮件地址

email_bulk_validate

一次请求中验证最多 100 个电子邮件地址


电话号码验证(phone-validation)— 2 个工具

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

工具

描述

phone_validate

验证单个电话号码

phone_bulk_validate

一次请求中验证最多 100 个电话号码


SSL(ssl)— 2 个工具

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

工具

描述

ssl_live_lookup

获取域名的实时 SSL 证书

ssl_live_chain_lookup

获取域名的完整 SSL 证书链


域名(domain)— 4 个工具

支持批量查询的域名可用性检查、建议及子域名发现。

工具

描述

domain_check_availability

检查域名是否可注册

domain_check_availability_with_suggestions

检查可用性并获取备选域名建议

domain_subdomain_lookup

分页列出为某域名发现的子域名

domain_bulk_check_availability

一次检查最多 100 个域名的可用性


截图(screenshot)— 3 个工具

捕获任意网页的截图和滚动录制。

工具

描述

screenshot_capture

捕获网页截图并返回图片 URL

screenshot_bulk_capture

一次请求中捕获最多 50 个网页的截图

screenshot_capture_scrolling

录制网页的滚动视频或动画 GIF


PDF(pdf)— 20 个工具

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

作业(合并、拆分、转换等)是异步的:它们会返回一个 taskId。使用 pdf_task_status 检查进度。本地文件需要绝对路径(MCP 服务器会读取磁盘)。您也可以传入已存储的 file_id。模板生成(pdf_generatepdf_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

线性化以实现快速 Web 查看

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 个工具

黄金、石油和农产品等大宗商品的实时及历史价格。

工具

描述

commodity_latest_rates

一种或多种大宗商品的实时价格

commodity_historical_rates

指定日期大宗商品的历史 OHLC 价格

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

查找中心点给定半径内的所有邮政编码

zipcode_distance

计算从基准点到最多 100 个邮政编码的距离

zipcode_by_city

获取某个城市的所有 ZIP/邮政编码

zipcode_bulk_lookup

一次查询最多 100 个 ZIP/邮政编码

zipcode_distance_match

查找给定距离阈值内的所有邮政编码对

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

在单个请求中解析最多100个用户代理字符串


支持


许可证

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


隐私政策

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

A
license - permissive license
A
quality
A
maintenance

Maintenance

Maintainers
Response time
2wRelease cycle
7Releases (12mo)
Commit activity

Related MCP Servers

  • F
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to access real-time and historical weather data through multiple weather APIs including OpenMeteo, Tomorrow.io, and OpenWeatherMap. Provides comprehensive meteorological information including current conditions, forecasts, historical data, and weather alerts.
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI assistants to fetch real-time weather data, forecasts up to 10 days, and compare weather conditions between cities using WeatherAPI.com with support for both Celsius and Fahrenheit units.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides real-time weather data and forecasts for locations worldwide using the OpenWeatherMap API. It enables AI assistants to retrieve current conditions, temperature, and forecasts through a simple tool-based interface.
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Exposes public weather and climate data through a standardized API, allowing AI agents to retrieve current conditions, 7-day forecasts, and historical data. It enables weather-aware automation and data enrichment for conversational agents and travel planning.

View all related MCP servers

Related MCP Connectors

  • Live & historical FX rates and currency conversion for AI agents. No API keys.

  • US weather & geo for AI agents: forecasts, alerts, earthquakes, elevation, geocoding. No keys.

  • US weather, alerts, earthquakes and elevation for AI agents, from NWS/NOAA and USGS. No API keys.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/api-freaks/apifreaks-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server