Globalping MCP Server

官方

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

GitHub
59

文件

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 客戶端提供詳細的參數描述，以便智慧選擇測量類型和選項
  • 🔄 比較分析：允許比較不同目標之間的網路效能
  • 🔑 驗證支援：使用 OAuth 或 API 權杖搭配您的 Globalping 帳戶，以獲得更高的速率限制

安裝

遠端 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（透過 Console）

在 Anthropic Console 中建立 Claude 助手時：

  1. 前往 console.anthropic.com
  2. 導覽至 Assistants 區段
  3. 建立新的助手或編輯現有助手
  4. 在 Tools 區段中，選取「Add custom tool」
  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. 導覽至 Tools & MCP 分頁
  3. 點選「+ New MCP server」
  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. 導覽至 Tokens 以產生新的 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 Assistants
  • 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 網頁路由
  • 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