probeops-mcp-server

本地服务

probeops.com云与基础设施036 周前更新

代码仓库访问官网

关于 probeops-mcp-server

ProbeOps MCP Server 为运维人员和开发者提供从多个全球区域执行的基础设施诊断。它将 SSL、DNS、连通性和延迟检查等结果按区域返回，并提供地理代理浏览功能。

主要功能

01跨区域执行网络与基础设施诊断
02检查 SSL、DNS、端口及延迟
03提供 ping、traceroute 和 whois 查询
04支持地理代理浏览及区域资源
05返回配额与账户状态

适用场景

01比较服务在不同区域的可用性
02排查 DNS 传播或网络延迟问题
03检查证书、端口和 API 健康状态
04从指定地区查看网页内容

MCP 相关

该 MCP 服务向兼容客户端提供基础设施诊断、地理代理浏览和账户管理工具，并提供区域、代理区域及用量资源。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "kumarprobeops-probeops": {
      "command": "npx",
      "args": [
        "-y",
        "@probeops/mcp-server"
      ],
      "env": {
        "PROBEOPS_API_KEY": "<PROBEOPS_API_KEY>"
      }
    }
  }
}

启动命令npx -y @probeops/mcp-server

需要配置的环境变量

PROBEOPS_API_KEY密钥ProbeOps API key (optional, runs in demo mode without it)

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@probeops/mcp-server1.2.3stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
domain	string	是	要检查的域名（例如，"example.com"）

详细介绍

ProbeOps MCP 服务

用于从全球 6 个区域运行基础设施诊断的 MCP 服务。SSL 检查、DNS 查询、ping、whois、端口检查、traceroute、延迟测试等，均会从美国东部、美国西部、欧盟中部、加拿大、印度和澳大利亚同时执行。

立即可用，无需 API 密钥。 运行 npx @probeops/mcp-server，即可获得 11 个诊断工具，每天可免费调用 10 次。添加 API 密钥即可解锁全部 21 个工具、6 个区域和更高的使用限额。

兼容 Claude Code、Codex、Cursor、Windsurf、Cline，以及任何兼容 Model Context Protocol 的客户端。

快速开始

选项 1：立即试用（无需 API 密钥）

Claude Code：

claude mcp add probeops -- npx -y @probeops/mcp-server

Codex：

codex mcp add probeops -- npx -y @probeops/mcp-server

Cursor / Windsurf / Cline（添加到 .mcp.json 或客户端的 MCP 配置中）：

{
  "mcpServers": {
    "probeops": {
      "command": "npx",
      "args": ["-y", "@probeops/mcp-server"]
    }
  }
}

就是这样。你将获得 11 个工具，每天可调用 10 次，并可使用 2 个探测区域，无需注册或配置。

选项 2：完整访问权限（免费 API 密钥）

在 probeops.com 注册，并从控制面板创建 API 密钥。然后将密钥添加到配置中：

Claude Code：

claude mcp add probeops -e PROBEOPS_API_KEY=your-key -- npx -y @probeops/mcp-server

Codex（添加到 ~/.codex/config.toml）：

[mcp_servers.probeops]
command = "npx"
args = ["-y", "@probeops/mcp-server"]

[mcp_servers.probeops.env]
PROBEOPS_API_KEY = "your-api-key-here"

Cursor / Windsurf / Cline：

{
  "mcpServers": {
    "probeops": {
      "command": "npx",
      "args": ["-y", "@probeops/mcp-server"],
      "env": {
        "PROBEOPS_API_KEY": "your-api-key-here"
      }
    }
  }
}

演示模式与完整访问权限

	演示模式（无密钥）	免费套餐（使用密钥）	专业版
工具	11	21	21
每日调用次数	10	100	5,000
每次调用的区域数	2	4	6
地理代理浏览	—	每天 3 小时	每天 10 小时
设置时间	0 分钟	2 分钟	2 分钟

你将获得

21 个基础设施诊断工具，每个工具都可从最多 6 个区域同时运行。此外还提供地理代理浏览和账户管理功能。

每次诊断工具调用都会返回各区域的结果和显示剩余用量的配额页脚。

诊断工具（14）

工具	功能	示例输入
`ssl_check`	SSL/TLS 证书有效性、到期时间、颁发者、TLS 版本、SAN，以及跨区域一致性	`{ "domain": "example.com" }`
`dns_lookup`	DNS 记录查询（A、AAAA、CNAME、MX、TXT、NS、SOA、CAA、PTR），并检查多区域传播情况	`{ "domain": "example.com", "record_type": "MX" }`
`is_it_down`	检查网站在多个区域的正常、宕机或部分可用状态	`{ "url": "https://example.com" }`
`latency_test`	从多个区域测试 HTTP 延迟（TTFB），返回最小值、平均值和最大值	`{ "target": "example.com" }`
`traceroute`	跟踪网络路径并显示每一跳的延迟。支持 TCP、UDP 或 ICMP	`{ "target": "example.com", "protocol": "tcp" }`
`port_check`	从多个区域检查端口是否开放、关闭或被过滤	`{ "target": "example.com", "port": 443 }`
`ping`	ICMP ping，显示丢包率和往返时间	`{ "target": "8.8.8.8" }`
`whois`	域名注册信息：注册商、日期、名称服务器	`{ "domain": "example.com" }`
`nmap_port_check`	使用 nmap 检查多个端口是否开放或关闭（非完整扫描）	`{ "target": "example.com", "ports": "80,443" }`
`tcp_ping`	测试到指定端口的 TCP 层延迟（ICMP 被阻止时仍可使用）	`{ "target": "example.com", "port": 443 }`
`keyword_check`	从多个区域检查网页中是否包含某个关键词	`{ "url": "https://example.com", "keyword": "pricing" }`
`websocket_check`	检查 WebSocket 端点的连通性	`{ "url": "wss://example.com/ws" }`
`banner_grab`	检测端口上的服务横幅和版本	`{ "target": "example.com", "port": 22 }`
`api_health`	检查 API 端点健康状态（HTTP 状态、响应时间、可用性）	`{ "url": "https://api.example.com/health" }`

DNS 快捷工具

这些工具会使用预设的 record_type 调用 dns_lookup，无需记忆记录类型名称：

工具	等效调用
`mx_lookup`	使用 `record_type: "MX"` 调用 `dns_lookup`
`txt_lookup`	使用 `record_type: "TXT"` 调用 `dns_lookup`
`ns_lookup`	使用 `record_type: "NS"` 调用 `dns_lookup`
`cname_lookup`	使用 `record_type: "CNAME"` 调用 `dns_lookup`
`caa_lookup`	使用 `record_type: "CAA"` 调用 `dns_lookup`
`reverse_dns_lookup`	使用 `record_type: "PTR"` 调用 `dns_lookup`（接受 IP 地址）

地理代理浏览

工具	功能	示例输入
`get_geo_proxy`	获取某个区域的代理凭据。可与 Playwright 或任何 HTTPS 代理客户端配合使用	`{ "region": "eu-central" }`
`geo_browse`	使用真实浏览器从某个区域浏览 URL。返回页面内容和／或截图	`{ "url": "https://example.com", "region": "ap-south" }`

账户

工具	功能
`account_status`	当前配额使用情况（分钟／小时／天／月）、订阅级别和有效代理令牌

资源

URI	描述
`probeops://regions`	探测区域及其位置、国家和节点数量
`probeops://proxy-regions`	地理代理区域及其 FQDN 和代理 URL
`probeops://usage`	当前 API 使用情况、剩余配额和有效令牌状态

全球区域

所有诊断工具都会同时从以下 6 个区域运行：

区域代码	位置	国家
`us-east`	弗吉尼亚州阿什本	美国
`us-west`	俄勒冈州博德曼	美国
`eu-central`	赫尔辛基	芬兰
`ca-central`	蒙特利尔	加拿大
`ap-south`	孟买	印度
`ap-southeast`	悉尼	澳大利亚

Geo-Proxy 令牌管理

服务会自动管理代理令牌：

令牌状态	操作	配额消耗
剩余时间 > 5 分钟	复用缓存的令牌	0
剩余时间为 0–5 分钟	自动延长 +1 小时	1 单位
已过期或没有令牌	生成新令牌	1 单位

单个令牌适用于全部 6 个区域。切换区域不会消耗配额。
每日配额 = 每天代理浏览的总小时数。
配额于 UTC 午夜重置。

输出示例

SSL 检查

ssl_check({ domain: "github.com" })

SSL Certificate Report for github.com
  Status: VALID
  Subject: github.com
  Issuer: DigiCert (DigiCert Inc)
  Expires in: 245 days
  TLS: TLSv1.3 (TLS_AES_256_GCM_SHA384)

  Region Results:
  | Region | Location | Status | Time |
  |--------|----------|--------|------|
  | us-east | Ashburn | OK | 45ms |
  | eu-central | Helsinki | OK | 38ms |
  | ap-south | Mumbai | OK | 112ms |
  | us-west | Boardman | OK | 52ms |
  | ca-central | Montreal | OK | 41ms |
  | ap-southeast | Sydney | OK | 98ms |

  Completed in 125ms
---
Diagnostics: 97 of 100 remaining today (Free)

Ping

ping({ target: "1.1.1.1" })

Ping: 1.1.1.1

  ap-south (Mumbai):
    PING 1.1.1.1 (1.1.1.1) 56(84) bytes of data.
    64 bytes from 1.1.1.1: icmp_seq=1 ttl=56 time=1.35 ms
    3 packets transmitted, 3 received, 0% packet loss
    rtt min/avg/max/mdev = 1.353/1.398/1.474/0.054 ms
    Response time: 2147ms

  eu-central (Helsinki):
    PING 1.1.1.1 (1.1.1.1) 56(84) bytes of data.
    64 bytes from 1.1.1.1: icmp_seq=1 ttl=54 time=21.2 ms
    3 packets transmitted, 3 received, 0% packet loss
    rtt min/avg/max/mdev = 20.651/20.941/21.217/0.231 ms
    Response time: 2031ms
  ...

  Completed in 2332ms
---
Diagnostics: 96 of 100 remaining today (Free)

Whois

whois({ domain: "example.com" })

Whois: example.com

  us-east (Ashburn):
    Domain Name: EXAMPLE.COM
    Registry Domain ID: 2336799_DOMAIN_COM-VRSN
    Registrar: RESERVED-Internet Assigned Numbers Authority
    Creation Date: 1995-08-14T04:00:00Z
    Registry Expiry Date: 2025-08-13T04:00:00Z
    Name Server: A.IANA-SERVERS.NET
    Name Server: B.IANA-SERVERS.NET
    DNSSEC: signedDelegation
    Response time: 734ms
  ...

  Completed in 852ms
---
Diagnostics: 95 of 100 remaining today (Free)

环境变量

变量	必需	默认值	描述
`PROBEOPS_API_KEY`	否	-	你的 ProbeOps API 密钥（免费获取）。没有密钥时，将以演示模式运行（11 个工具，每天 10 次调用）
`PROBEOPS_BASE_URL`	否	`https://probeops.com`	API 基础 URL（用于预发布或可自托管实例）

速率限制

	免费版	标准版	专业版
每分钟	15	30	50
每小时	100	500	2,000
每天	100	1,000	5,000
每月	500	20,000	100,000
并发数	3	5	10
每日代理小时数	3	5	10
区域	6 个中的 4 个	全部 6 个	全部 6 个

免费套餐无需信用卡。随时使用 account_status 查看用量。

当前详情请参阅 probeops.com/pricing。

开发

git clone https://github.com/kumarprobeops/probeops-mcp-server.git
cd probeops-mcp-server
npm install
npm run build

本地测试：

PROBEOPS_API_KEY=your-key node dist/index.js

要求

Node.js >= 18.0.0
Playwright（可选）——仅 geo_browse 截图功能需要
```
npx playwright install chromium
```
如果没有 Playwright，geo_browse 将回退到 HTTP 获取（原始 HTML，不含截图）。

常见问题

问：这与在本地运行 curl 或 dig 有什么不同？ 每项检查都会同时从 6 个全球区域运行。你可以了解全球真实用户视角下的 DNS 传播、延迟和可用性，而非本地网络的情况。

问：除了 Node.js，我还需要安装其他东西吗？ 不需要。npx -y @probeops/mcp-server 会处理所有事项。Playwright 是可选的（仅用于 geo_browse 截图）。

问：我可以在 CI/CD 流水线中使用它吗？ 可以。将 PROBEOPS_API_KEY 设置为环境变量，然后从任何兼容 MCP 的工具调用 MCP 服务。

问：API 密钥会安全地发送吗？ 会。所有通信都使用 HTTPS。密钥通过 X-API-Key 标头发送，绝不会出现在 URL 或日志中。

许可证

MIT——参见 LICENSE

链接

支持 Markdown

登录后评论

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

阅读入门指南

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。