Globalping

官方

具備執行 ping、traceroute、mtr、http、dns resolve 等指令的網路存取能力。

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 伺服器實作了 Model Context Protocol (MCP)，讓 AI 模型和 IDE 輔助工具能夠透過自然語言與 Globalping 的網路測量功能互動。

此伺服器支援標準的 OAuth 2.0 認證 以及 API Token 認證，適用於自動化工作流程。

主要功能

🌐 全球網路存取：從全球數千個探測器執行測量
🤖 AI 友善介面：任何 LLM 都能輕鬆解析資料並視需要執行新的測量
📊 全面的測量類型：支援 ping、traceroute、DNS、MTR 和 HTTP 測試
🔍 智慧內容處理：詳細的參數描述和語意工具註解，實現智慧代理路由
🔄 比較分析：比較不同目標和地理位置之間的網路延遲與路由
🔑 認證支援：使用 OAuth 或 Globalping 帳戶的 API Token 以獲得更高的速率限制

安裝

所有現代 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 中，前往設定 → 連接器（Team/Enterprise 帳戶請前往 組織設定 → 連接器）。
點擊 + 新增自訂連接器。
填寫連接器詳細資訊：

名稱：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 Token：適用於無頭腳本、CI/CD 管線或程式化 API 用戶端。

使用 Globalping API Token

前往 dash.globalping.io 並在 Tokens 下產生 API Token。
透過標準 HTTP 標頭傳遞 Token：

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

程式化整合（Anthropic Messages API）

若要直接將 Globalping 與 Anthropic 的 Messages API（MCP 連接器）搭配使用，請在請求負載中傳遞遠端伺服器定義：

{
  "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 外掛目錄網域驗證，請儲存提交入口網站產生的 Token：

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。