Globalping

官方

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

GitHub
62

你可以用 Globalping MCP 做什么？

  • 从全球探测点运行ping测试 — 要求助手使用ping从特定区域、国家或城市对目标进行ping操作。
  • 使用traceroute或MTR追踪网络路径 — 请求执行traceroute或mtr，以可视化数据包从全球探测点经过的路由。
  • 从任意位置查询DNS记录 — 使用dns从全球探测点通过自定义解析器（例如Google DNS）解析域名。
  • 检查HTTP可达性和响应时间 — 对URL运行http测试，以测量来自不同区域的状态码、时间和头部信息。
  • 比较不同位置的网络性能 — 使用compareLocations指导进行并排测量，对比目标之间的延迟或路由。
  • 获取历史测量结果并检查速率限制 — 通过getMeasurement按ID获取之前的结果，或通过limits查看当前API限制。

文档

Globalping MCP 服务器

Globalping Logo

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

MCP Compatible

什么是 Globalping？

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

什么是 Globalping MCP 服务器？

Globalping MCP 服务器实现了模型上下文协议 (MCP)，允许像 OpenAI 的 GPT 和 Anthropic 的 Claude 这样的 AI 模型通过自然语言与 Globalping 的网络测量功能进行交互。

它还支持两种身份验证方法：OAuth 和 API 令牌认证。这两种方法都提供了与我们的 API 交互的安全方式，并提供与你账户关联的更高频率限制。

主要功能

  • 🌐 全球网络访问：从全球数千个探测点运行测量
  • 🤖 AI 友好界面：任何 LLM 都能轻松解析数据，并根据需要运行新的测量
  • 📊 全面的测量：支持 ping、traceroute、DNS、MTR 和 HTTP 测试
  • 🔍 智能上下文处理：为 AI 客户端提供详细的参数描述，以便智能选择测量类型和选项
  • 🔄 对比分析：允许比较不同目标之间的网络性能
  • 🔑 身份验证支持：使用你的 Globalping 账户的 OAuth 或 API 令牌以获得更高的频率限制

安装

远程 MCP 服务器可通过以下端点访问：

  • 可流式传输的 HTTP 传输：https://mcp.globalping.dev/mcp
  • SSE 传输：https://mcp.globalping.dev/sse

你可以将我们的 Globalping MCP 服务器与支持模型上下文协议的各种 AI 工具集成。

以下是三大最受欢迎工具的说明：

Gemini CLI

要将 Globalping MCP 服务器添加到 Gemini CLI：

  1. 确保你已安装 Gemini CLI。
  2. 运行以下命令：
gemini extensions install https://github.com/jsdelivr/globalping-mcp-server

这将自动配置服务器并启用 OAuth 身份验证。首次使用该扩展时，系统会提示你登录。

注意： 如果你更喜欢使用 Globalping API 令牌（以获得更高的频率限制或用于自动化），你可以手动添加带有 Authorization 标头的服务器，而不是使用扩展安装程序：

gemini mcp add globalping https://mcp.globalping.dev/mcp --header "Authorization: Bearer YOUR_TOKEN"

Claude 桌面应用

添加到你的 Claude 桌面配置文件（位于 Windows 上的 %APPDATA%\Claude\config.json 或 macOS 上的 ~/Library/Application Support/Claude/config.json）：

[!note] Claude 桌面原生仅支持本地 MCP 服务器的 stdio 传输。 对于远程 MCP 服务器，请使用 mcp-remote 桥接。

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/sse"
            ]
        }
    }
}

Anthropic Claude API（通过控制台）

在 Anthropic 控制台中创建 Claude 助手时：

  1. 前往 console.anthropic.com
  2. 导航到助手部分
  3. 创建一个新助手或编辑现有助手
  4. 在工具部分，选择“添加自定义工具”
  5. 输入以下详细信息：
    • 工具名称：Globalping
    • 描述：Run network tests from locations worldwide
    • 工具 URL：https://mcp.globalping.dev/mcp（可流式传输的 HTTP 传输）或 https://mcp.globalping.dev/sse（SSE 传输）

Cursor

要将 Globalping MCP 服务器添加到 Cursor：

  1. 打开 Cursor 设置
  2. 导航到“工具与 MCP”选项卡
  3. 点击“+ 新建 MCP 服务器”
  4. 这将打开 mcp.json 配置文件，你需要添加以下内容：

可流式传输的 HTTP 传输：

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

旧版 SSE 传输：

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/sse"
            ]
        }
    }
}
  1. 保存并重启 Cursor

身份验证

Globalping MCP 服务器支持两种身份验证方法：

  • OAuth 身份验证：由服务器自动处理，以实现安全访问
  • API 令牌认证：通过 Authorization 标头手动配置令牌

这两种方法都提供更高的频率限制和对探测网络的优先访问。

使用 Globalping API 令牌

服务器会自动检测 Authorization 标头中是否提供了 API 令牌，并使用它进行身份验证，而不是 OAuth。

获取你的 API 令牌

  1. 访问 dash.globalping.io
  2. 登录你的账户
  3. 导航到“令牌”以生成新的 API 令牌

带身份验证的配置

可流式传输的 HTTP 传输：

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

旧版 SSE 传输：

{
    "mcpServers": {
        "globalping": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://mcp.globalping.dev/sse",
                "--header",
                "Authorization: Bearer YOUR_GLOBALPING_API_TOKEN"
            ]
        }
    }
}

连接 AI 助手

你可以将我们的 MCP 服务器与任何兼容 MCP 的 AI 助手一起使用，包括：

  • Claude 桌面
  • Anthropic 助手
  • Cursor
  • Windsurf
  • 任何 MCP 协议的自定义实现

有关将客户端连接到此服务器的详细信息，请参阅你所用工具的 MCP 文档。

可用工具

  • ping - 对目标执行 ping 测试
  • traceroute - 对目标执行 traceroute 测试
  • dns - 对域名执行 DNS 查询
  • mtr - 对目标执行 MTR（我的路由追踪）测试
  • http - 对 URL 执行 HTTP 请求
  • locations - 列出所有可用的 Globalping 探测位置
  • limits - 显示你当前在 Globalping API 的频率限制
  • getMeasurement - 通过 ID 检索之前运行的测量
  • compareLocations - 关于如何运行对比测量的指南
  • help - 显示包含可用工具文档的帮助消息

使用示例

一旦通过兼容的 MCP 客户端连接到 AI 模型，你就可以使用自然语言与 Globalping 交互：

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”等。
  • 国家代码：“US”、“DE”、“JP”等。
  • 城市名称：“London”、“Tokyo”、“New York”等。
  • 网络名称：“Cloudflare”、“Google”等。
  • ASN 号码：“AS13335”、“AS15169”等。
  • 云提供商区域：“aws-us-east-1”、“gcp-us-central1”等。

你还可以使用加号组合这些内容以实现更具体的定位：“London+UK”、“Cloudflare+US”等。

开发

代码库按模块组织：

  • src/index.ts - 主入口点和 MCP 代理定义
  • src/app.ts - OAuth Web 路由
  • src/api - Globalping API 客户端
  • src/auth - 身份验证实用程序
  • src/config - 配置和常量
  • src/lib - 实用函数
  • src/mcp - MCP 工具处理程序
  • src/types - TypeScript 类型定义
  • src/ui - HTML 模板

添加 Globalping 凭据

添加 Globalping OAuth 凭据：

  • npx wrangler secret put GLOBALPING_CLIENT_ID

KV 存储

用于 OAuthProvider 文档 https://github.com/cloudflare/workers-oauth-provider

  • 创建一个 KV 命名空间并复制 ID
  • 其绑定必须为 OAUTH_KV
  • 在 wrangler.jsonc 文件中配置 kv_namespaces