RIPE Atlas

RIPE Atlas MCP 服务

这是一个面向 RIPE Atlas 网络测量平台的 Model Context Protocol (MCP) 服务。可让 AI 助手创建网络测量、获取结果、搜索探针并管理积分。

功能

• 全部 6 种测量类型：ping、traceroute、DNS、TLS/SSL、HTTP、NTP
• 灵活选择探针：按国家、ASN、前缀、地理区域、指定探针或标签筛选
• 丰富的结果获取选项：按时间范围筛选、按探针筛选、仅显示最新结果
• 双输出格式：JSON（结构化）和 Markdown（便于阅读）
• 探针发现：按位置、网络和状态搜索全球 12,000 多个探针
• 积分管理：查看余额和使用统计信息

快速开始

使用 npx（推荐）

npx ripe-atlas-mcp-server

全局安装

npm install -g ripe-atlas-mcp-server

配置

前置条件

1. 在 atlas.ripe.net 创建免费账户
2. 在 atlas.ripe.net/keys/ 创建具有“Create measurements”权限的 API 密钥
3. 设置环境变量：export RIPE_ATLAS_API_KEY=your_key_here

**注意：**只读操作（列出测量、搜索探针）无需 API 密钥。创建测量需要 API 密钥。

Claude Desktop

添加到 Claude Desktop 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "ripe-atlas": {
      "command": "npx",
      "args": ["-y", "ripe-atlas-mcp-server"],
      "env": {
        "RIPE_ATLAS_API_KEY": "your_key_here"
      }
    }
  }
}

VS Code / GitHub Copilot

添加到 VS Code 设置或 .vscode/mcp.json：

{
  "mcpServers": {
    "ripe-atlas": {
      "command": "npx",
      "args": ["-y", "ripe-atlas-mcp-server"],
      "env": {
        "RIPE_ATLAS_API_KEY": "your_key_here"
      }
    }
  }
}

Cursor

添加到 Cursor MCP 配置：

{
  "mcpServers": {
    "ripe-atlas": {
      "command": "npx",
      "args": ["-y", "ripe-atlas-mcp-server"],
      "env": {
        "RIPE_ATLAS_API_KEY": "your_key_here"
      }
    }
  }
}

工具

测量创建

工具	描述
atlas_measure_ping	从分布式探针创建 ICMP ping 测量
atlas_measure_traceroute	创建 traceroute 测量（ICMP/UDP/TCP）
atlas_measure_dns	创建支持 DNSSEC 的 DNS 查询测量
atlas_measure_tls	创建 TLS/SSL 证书检查测量
atlas_measure_http	创建 HTTP 请求测量（GET/HEAD/POST）
atlas_measure_ntp	创建 NTP 时间查询测量

测量管理

工具	描述
atlas_list_measurements	按筛选条件搜索并列出测量
atlas_get_measurement	按 ID 获取测量详细信息
atlas_get_results	按时间或探针筛选条件获取测量结果
atlas_stop_measurement	停止正在运行的测量

探针

工具	描述
atlas_search_probes	按国家、ASN、前缀、状态和标签搜索探针
atlas_get_probe	按 ID 获取探针详细信息

账户

工具	描述
atlas_get_credits	查看积分余额和使用统计信息

常用参数

所有测量创建工具均支持：

参数	描述
target	目标主机名或 IP 地址
af	地址族：4（IPv4）或 6（IPv6）
probe_count	探测次数（1-1000，默认值：5）
from_country	两字母 ISO 国家/地区代码（例如：AU、DE、US）
from_asn	自治系统编号
from_prefix	IP 前缀（例如：193.0.0.0/21）
from_area	地理区域：WW、West、North-Central、South-Central、North-East、South-East
from_probes	以逗号分隔的探测 ID
include_tags / exclude_tags	按标签筛选探测点
is_oneoff	单次（true，默认值）或定期（false）
response_format	json（默认值）或 markdown

示例

从全球随机选择的 10 个探测点 ping 目标：

“从全球 10 个探测点 ping 1.1.1.1”

检查 DNS 传播情况：

“从全球 50 个探测点查询 example.com 的 AAAA 记录”

查找某个国家/地区的探测点：

“显示澳大利亚所有已连接的 RIPE Atlas 探测点”

追踪路由：

“使用 ICMP 从德国的 5 个探测点向 8.8.8.8 运行 traceroute”

什么是 RIPE Atlas？

RIPE Atlas 是由 RIPE NCC 运营的全球互联网测量网络。它由志愿者在世界各地托管的数千个硬件和软件探测点组成。用户可以从这些分布式观测点运行网络测量（ping、traceroute、DNS、TLS、HTTP、NTP），从而了解全球互联网路由、性能和 DNS 解析情况。

开发

git clone https://github.com/jrelph/ripe-atlas-mcp.git
cd ripe-atlas-mcp-server
npm install
npm run build

贡献

详情请参阅 CONTRIBUTING.md。

许可证

MIT