Globalping MCP Server

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 トークン認証の両方をサポートしています。

主な機能

• 🌐 グローバルネットワークへのアクセス：世界中の数千か所にあるプローブから測定を実行できます
• 🤖 AI フレンドリーなインターフェース：あらゆる LLM がデータを簡単に解析し、必要に応じて新たな測定を実行できます
• 📊 包括的な測定：ping、traceroute、DNS、MTR、HTTP テストをサポートしています
• 🔍 スマートなコンテキスト処理：詳細なパラメーターの説明と意味に基づくツールの注釈により、エージェントを適切にルーティングできます
• 🔄 比較分析：異なるターゲットや地理的な場所間で、ネットワークのレイテンシとルーティングを比較できます
• 🔑 認証のサポート：Globalping アカウントで OAuth または API トークンを使用すると、より高いレート制限が適用されます

---

インストール

最新の MCP 統合で使用する標準エンドポイントは次のとおりです。

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

ChatGPT と Codex

ChatGPT と Codex で Globalping をリモート MCP サーバーとして接続します。

ChatGPT（Web とデスクトップ）

1. ChatGPT で Settings → Security and login に移動し、Developer mode を有効にします（ChatGPT デスクトップでは 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（Web、デスクトップ）

Claude は、ローカルの mcp-remote ブリッジを必要とせず、リモート Streamable HTTP MCP コネクターをネイティブにサポートしています。

1. Claude で Settings → Connectors に移動します（Team／Enterprise アカウントの場合は Organization settings → Connectors に移動します）。
2. + Add custom connector をクリックします。
3. コネクターの詳細を入力します。

• Name：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 で手動設定します。

• Type：SSE / HTTP
• Name：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 は、次の 2 つの認証方式に対応しています。

• OAuth 2.0：接続時に、対話型クライアントで自動的に処理されます。
• API トークン：ヘッドレススクリプト、CI/CD パイプライン、またはプログラムから利用する API クライアントに便利です。

Globalping API トークンの使用

1. dash.globalping.io にアクセスし、Tokens で API トークンを生成します。
2. 標準の HTTP ヘッダーでトークンを渡します。

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

---

プログラムからの統合（Anthropic Messages API）

Globalping を Anthropic の Messages API（MCP Connector）で直接使用するには、リクエストのペイロードにリモートサーバーの定義を渡します。

{
  "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	現在の 1 時間あたりの無料テスト枠と追加クレジットを表示します
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 が返されるのは想定どおりです。統合を再接続し、ブラウザーでの認証フローを完了してください。
• レガシーの /sse エンドポイントは、Streamable HTTP に対応していないクライアントでのみ使用してください。

認証に失敗する、または期限切れになる

• 統合を削除して再接続し、新しい OAuth フローを開始します。
• API トークン認証の場合は、Globalping ダッシュボードで有効なトークンを生成し、Authorization: Bearer YOUR_GLOBALPING_API_TOKEN として送信します。
• 接続後、authStatus ツールで認証が有効であることを確認し、limits ツールで 1 時間あたりの無料テスト枠と利用可能なクレジットを確認します。表示されるレート制限は無料テストのみを対象としています。クレジットを保有する認証済みユーザーは、追加テストごとにクレジットを 1 つ消費することで、制限を超えて利用できます。

ヘルプの利用または問題の報告

• 使用方法に関する質問や再現可能なバグについては、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 を設定します。