Globalping MCP Server

Globalping MCP 服务

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

什么是 Globalping？

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

什么是 Globalping MCP 服务？

Globalping MCP 服务实现了 Model Context Protocol（MCP），使 AI 模型和 IDE 助手能够通过自然语言使用 Globalping 的网络测量功能。

该服务支持标准的 OAuth 2.0 身份验证，也支持在自动化工作流中使用 API 令牌身份验证。

主要功能

• 🌐 全球网络访问：从全球数千个探测节点运行测量
• 🤖 便于 AI 使用的界面：任意大模型都能轻松解析数据，并根据需要运行新的测量
• 📊 全面的测量功能：支持 ping、traceroute、DNS、MTR 和 HTTP 测试
• 🔍 智能上下文处理：提供详细的参数说明和语义化工具注释，便于智能 Agent 路由
• 🔄 对比分析：比较不同目标和地理位置之间的网络延迟与路由
• 🔑 身份验证支持：使用 OAuth 或 Globalping 账户的 API 令牌，以获得更高的速率限制

---

安装

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

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

ChatGPT 和 Codex

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

ChatGPT（网页端和桌面端）

1. 在 ChatGPT 中，前往 Settings → Security and login 并启用 Developer mode（或在 ChatGPT Desktop 中前往 Settings → Features → MCP Servers）。
2. 添加新的自定义连接器 / MCP 服务，并使用以下端点：

https://mcp.globalping.dev/mcp

3. 根据提示通过 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 桥接：

1. 在 Claude 中，前往 Settings → Connectors（Team/Enterprise 账户请前往 Organization settings → Connectors）。
2. 点击 + Add custom connector。
3. 填写连接器详情：

• 名称：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：

也可以在 Settings → Features → MCP Servers → Add New MCP Server 中手动配置：

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

Gemini CLI

Globalping 已收录在官方 Gemini CLI Extensions Gallery 中。

使用 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 Token：适用于无头脚本、CI/CD 流水线或编程式 API 客户端。

使用 Globalping API Token

1. 前往 dash.globalping.io，在 Tokens 下生成 API token。
2. 通过标准 HTTP 标头传递 token：

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

---

编程式集成（Anthropic Messages API）

要通过 Anthropic 的 Messages API（MCP Connector）直接使用 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 token 身份验证，请在 Globalping 控制面板中生成当前有效的 token，并将其作为 Authorization: Bearer YOUR_GLOBALPING_API_TOKEN 发送。
• 连接后，使用 authStatus 工具验证身份验证是否已启用，并使用 limits 工具查看每小时免费测试额度和可用点数。显示的速率限制仅涵盖免费测试；有点数的已验证用户可以通过每增加一项测试消耗一点数，继续超过该限制。

获取帮助或报告问题

• 如有使用问题或可复现的错误，请提交 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 状态管理：

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