Globalping

官方

具备运行ping、traceroute、mtr、http、dns解析等命令的网络访问能力。

GitHub

你可以用 Globalping MCP 做什么？

运行网络诊断 — 可向任何目标发起 ping、traceroute、mtr 或 http 测试，并指定全球特定位置。
解析 DNS 查询 — 使用 dns 工具，通过自定义解析器（如 Google DNS 8.8.8.8）检查记录。
比较多区域性能 — 利用 compareLocations 对跨大洲或城市的延迟和路由进行基准测试。
获取历史结果 — 通过 getMeasurement 按 ID 获取过往测量数据，用于审计或分析。
检查账户状态 — 使用 authStatus 和 limits 验证身份认证并查看每小时测试配额。
发现探测点位置 — 查询 locations 以列出可用的区域、网络和云提供商，便于精准定向。

文档

Globalping MCP 服务器

让 AI 模型能够通过自然语言与全球网络测量平台交互。为任何 LLM 提供网络访问能力。

什么是 Globalping？

Globalping 是一个免费的公共 API，提供对全球分布式探针网络的访问，用于监控、调试和基准测试互联网基础设施。借助 Globalping，您可以从全球数千个位置运行网络测试（ping、traceroute、DNS、MTR、HTTP）。

什么是 Globalping MCP 服务器？

Globalping MCP 服务器实现了模型上下文协议（MCP），允许 AI 模型和 IDE 助手通过自然语言与 Globalping 的网络测量能力进行交互。

该服务器支持标准的 OAuth 2.0 认证 以及用于自动化工作流的 API 令牌认证。

主要特性

🌐 全球网络访问：从全球数千个探针运行测量
🤖 AI 友好接口：任何 LLM 都能轻松解析数据并按需运行新的测量
📊 全面的测量能力：支持 ping、traceroute、DNS、MTR 和 HTTP 测试
🔍 智能上下文处理：详细的参数描述和语义工具注释，实现智能代理路由
🔄 对比分析：比较不同目标和地理位置之间的网络延迟和路由
🔑 认证支持：使用 OAuth 或 Globalping 账户的 API 令牌以获得更高的速率限制

安装

所有现代 MCP 集成的主要端点为：

https://mcp.globalping.dev/mcp Streamable HTTP

ChatGPT 与 Codex

在 ChatGPT 和 Codex 中将 Globalping 连接为远程 MCP 服务器：

ChatGPT（网页版和桌面版）

在 ChatGPT 中，前往设置 → 安全与登录 并启用 开发者模式（或在 ChatGPT 桌面版中前往设置 → 功能 → MCP 服务器）。
使用以下端点添加新的自定义连接器 / MCP 服务器：

https://mcp.globalping.dev/mcp

在提示时通过 OAuth 进行认证。

OpenAI Codex

使用 Codex CLI 添加远程服务器：

codex mcp add globalping --url https://mcp.globalping.dev/mcp

或者直接添加到 ~/.codex/config.toml：

[mcp_servers.globalping]
url = "https://mcp.globalping.dev/mcp"

Claude（网页版、桌面版）

Claude 原生支持远程 Streamable HTTP MCP 连接器，无需本地 mcp-remote 桥接：

在 Claude 中，导航至设置 → 连接器（团队/企业账户为 组织设置 → 连接器）。
点击 + 添加自定义连接器。
填写连接器详细信息：

名称：Globalping
URL：https://mcp.globalping.dev/mcp

Claude Code

在终端中运行以下命令：

claude mcp add --transport http globalping https://mcp.globalping.dev/mcp

要使 Globalping 在您机器上的所有项目中可用（全局用户范围），而不仅仅是当前项目目录：

claude mcp add -s user --transport http globalping https://mcp.globalping.dev/mcp

如果通过 SSH 或在无头终端中工作，请运行 claude mcp login globalping --no-browser 以手动完成授权 URL 交换。

Cursor

一键将 Globalping 添加到 Cursor：

或者手动配置设置 → 功能 → MCP 服务器 → 添加新的 MCP 服务器：

类型：SSE / HTTP
名称：globalping
URL：https://mcp.globalping.dev/mcp

Gemini CLI

Globalping 已收录在官方的 Gemini CLI 扩展库 中。

通过 Gemini 扩展管理器安装：

gemini extensions install https://github.com/jsdelivr/globalping-mcp-server

（添加 --auto-update 以保持扩展自动更新）。

VS Code 与 GitHub Copilot

命令面板：运行 MCP: Add Server 并输入 https://mcp.globalping.dev/mcp。

通用 MCP 客户端

对于任何支持标准 Streamable HTTP MCP 传输的客户端，请添加：

{
  "mcpServers": {
    "globalping": {
      "url": "https://mcp.globalping.dev/mcp"
    }
  }
}

旧版客户端（SSE / stdio 回退）： 如果您的客户端严格要求通过本地进程桥接使用 SSE，请配置 npx mcp-remote https://mcp.globalping.dev/sse。

认证

Globalping MCP 支持两种认证模式：

OAuth 2.0：在交互式客户端连接时自动处理。
API 令牌：适用于无头脚本、CI/CD 管道或编程式 API 客户端。

使用 Globalping API 令牌

前往 dash.globalping.io 并在令牌下生成 API 令牌。
通过标准 HTTP 头传递令牌：

{
  "mcpServers": {
    "globalping": {
      "url": "https://mcp.globalping.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_GLOBALPING_API_TOKEN"
      }
    }
  }
}

编程式集成（Anthropic Messages API）

要直接通过 Anthropic 的 Messages API（MCP 连接器）使用 Globalping，请在请求负载中传递远程服务器定义：

{
  "model": "claude-3-7-sonnet-latest",
  "max_tokens": 1024,
  "mcp_servers": [
    {
      "type": "url",
      "name": "globalping",
      "url": "https://mcp.globalping.dev/mcp"
    }
  ],
  "tools": [
    {
      "type": "mcp_toolset",
      "mcp_server_name": "globalping"
    }
  ],
  "messages": [
    {
      "role": "user",
      "content": "Run a traceroute to 1.1.1.1 from Frankfurt and Tokyo."
    }
  ]
}

可用工具

工具	描述
`ping`	对目标执行 ICMP/数据包 ping 测试
`traceroute`	追踪到目标的网络路由跳数
`dns`	使用特定解析器和记录类型解析 DNS 查询
`mtr`	运行组合的 ping 和 traceroute 测试（My Traceroute）
`http`	从全球探针执行 HTTP/HTTPS 请求
`locations`	列出可用的 Globalping 探针区域和过滤器
`limits`	显示当前免费每小时测试配额和额外积分
`getMeasurement`	按 ID 检索历史测量的结果
`compareLocations`	比较多区域性能指标的辅助指南
`help`	工具参考和语法文档
`authStatus`	检查当前 MCP 认证状态

使用示例

连接后，使用自然语言运行网络诊断：

Ping google.com from 3 locations in Europe

Run a traceroute to github.com from Japan and compare with traceroute from the US

Check the DNS resolution of example.com using Google DNS (8.8.8.8)

Is jsdelivr.com reachable from China? Test with both ping and HTTP

What's the average response time for cloudflare.com across different continents?

位置指定

可以使用位置的 magic 参数来指定位置：

大洲：EU、NA、AS、AF、OC、SA
国家代码：US、DE、JP、PL、BR
城市：London、Tokyo、New York、Warsaw
网络与 ASN：Cloudflare、Google、AS13335、AS15169
云区域：aws-us-east-1、gcp-us-central1
组合：London+UK、Cloudflare+US、AWS+Frankfurt

故障排除与支持

连接器无法访问服务器

完全按照所示使用 Streamable HTTP 端点：https://mcp.globalping.dev/mcp。
在完成 OAuth 之前返回 401 Unauthorized 响应是正常的。重新连接集成并完成浏览器授权流程。
仅对不支持 Streamable HTTP 的客户端使用旧版 /sse 端点。

认证失败或过期

移除并重新连接集成以启动新的 OAuth 流程。
对于 API 令牌认证，请在 Globalping 仪表板中生成当前令牌，并将其作为 Authorization: Bearer YOUR_GLOBALPING_API_TOKEN 发送。
连接后，使用 authStatus 工具验证认证是否生效，并使用 limits 工具检查免费每小时测试配额和可用积分。显示的速率限制仅涵盖免费测试；拥有积分的已认证用户可以通过每次额外测试消耗一个积分来继续超出该限制。

获取帮助或报告问题

对于使用问题和可复现的 bug，请打开 GitHub issue。
对于安全敏感的报告，请使用 GitHub 的私有报告漏洞表单。请勿在公开 issue 中包含凭据或敏感数据。
Globalping 的隐私政策和使用条款适用于本服务。

开发

src/
├── index.ts        # Main entry point & MCP agent definition
├── app.ts          # OAuth web routes
├── api/            # Globalping API client
├── auth/           # Authentication helpers
├── config/         # Configuration & constants
├── lib/            # Utilities
├── mcp/            # MCP tool definitions & handlers
├── types/          # TypeScript interfaces
└── ui/             # OAuth HTML templates

凭据与密钥

存储 OAuth 凭据：

npx wrangler secret put GLOBALPING_CLIENT_ID

对于 OpenAI 插件目录域名验证，请存储提交门户生成的令牌：

npx wrangler secret put OPENAI_APPS_CHALLENGE

Worker 从 /.well-known/openai-apps-challenge 以纯文本形式提供此值。在配置密钥之前，该路由返回 404。

KV 存储设置

用于 Cloudflare Workers OAuth 状态管理：

创建 KV 命名空间：npx wrangler kv:namespace create OAUTH_KV
在 wrangler.jsonc 中配置 OAUTH_KV。