Globalping

chính thức

Truy cập mạng với khả năng chạy các lệnh như ping, traceroute, mtr, http, dns resolve.

Bạn có thể làm gì với Globalping MCP?

Chạy chẩn đoán mạng — Yêu cầu kiểm tra ping, traceroute, mtr hoặc http tới bất kỳ mục tiêu nào từ các vị trí toàn cầu cụ thể.
Giải quyết truy vấn DNS — Sử dụng công cụ dns để kiểm tra bản ghi qua các trình phân giải tùy chỉnh như Google DNS (8.8.8.8).
So sánh hiệu suất đa khu vực — Tận dụng compareLocations để đo điểm chuẩn độ trễ và định tuyến giữa các châu lục hoặc thành phố.
Truy xuất kết quả lịch sử — Lấy dữ liệu đo lường trước đó theo ID bằng getMeasurement để kiểm toán hoặc phân tích.
Kiểm tra trạng thái tài khoản — Sử dụng authStatus và limits để xác minh xác thực và xem xét hạn mức kiểm tra theo giờ.
Khám phá vị trí probe — Truy vấn locations để liệt kê các khu vực, mạng và nhà cung cấp đám mây có sẵn nhằm nhắm mục tiêu.

Tài liệu

Máy chủ MCP Globalping

Cho phép các mô hình AI tương tác với nền tảng đo lường mạng toàn cầu thông qua ngôn ngữ tự nhiên. Cung cấp quyền truy cập mạng cho bất kỳ LLM nào.

Globalping là gì?

Globalping là một API công khai miễn phí cung cấp quyền truy cập vào mạng lưới các thiết bị đo phân tán toàn cầu để giám sát, gỡ lỗi và đánh giá hiệu suất cơ sở hạ tầng internet. Với Globalping, bạn có thể chạy các bài kiểm tra mạng (ping, traceroute, DNS, MTR, HTTP) từ hàng nghìn vị trí trên toàn thế giới.

Máy chủ MCP Globalping là gì?

Máy chủ MCP Globalping triển khai Giao thức Ngữ cảnh Mô hình (MCP), cho phép các mô hình AI và trợ lý IDE tương tác với khả năng đo lường mạng của Globalping thông qua ngôn ngữ tự nhiên.

Máy chủ hỗ trợ xác thực OAuth 2.0 tiêu chuẩn cũng như xác thực bằng mã API cho các quy trình làm việc tự động.

Các tính năng chính

🌐 Truy cập mạng toàn cầu: Chạy các phép đo từ hàng nghìn thiết bị đo trên toàn thế giới
🤖 Giao diện thân thiện với AI: Bất kỳ LLM nào cũng có thể dễ dàng phân tích dữ liệu và chạy các phép đo mới khi cần
📊 Các phép đo toàn diện: Hỗ trợ các bài kiểm tra ping, traceroute, DNS, MTR và HTTP
🔍 Xử lý ngữ cảnh thông minh: Mô tả tham số chi tiết và chú thích ngữ nghĩa cho công cụ để định tuyến tác nhân thông minh
🔄 Phân tích so sánh: So sánh độ trễ mạng và định tuyến giữa các mục tiêu và vị trí địa lý khác nhau
🔑 Hỗ trợ xác thực: Sử dụng OAuth hoặc mã API với tài khoản Globalping của bạn để có giới hạn tốc độ cao hơn

Cài đặt

Điểm cuối chính cho tất cả các tích hợp MCP hiện đại là:

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

ChatGPT & Codex

Kết nối Globalping như một máy chủ MCP từ xa trong ChatGPT và Codex:

ChatGPT (Web & Desktop)

Trong ChatGPT, đi tới Cài đặt → Bảo mật và đăng nhập và bật Chế độ nhà phát triển (hoặc Cài đặt → Tính năng → Máy chủ MCP trong ChatGPT Desktop).
Thêm một trình kết nối / máy chủ MCP tùy chỉnh mới với điểm cuối:

https://mcp.globalping.dev/mcp

Xác thực qua OAuth khi được nhắc.

OpenAI Codex

Thêm máy chủ từ xa bằng Codex CLI:

codex mcp add globalping --url https://mcp.globalping.dev/mcp

Hoặc thêm vào ~/.codex/config.toml trực tiếp:

[mcp_servers.globalping]
url = "https://mcp.globalping.dev/mcp"

Claude (Web, Desktop)

Claude hỗ trợ các trình kết nối MCP Streamable HTTP từ xa một cách tự nhiên mà không cần các cầu nối mcp-remote cục bộ:

Trong Claude, điều hướng đến Cài đặt → Trình kết nối (hoặc Cài đặt tổ chức → Trình kết nối cho tài khoản Team/Enterprise).
Nhấp vào + Thêm trình kết nối tùy chỉnh.
Điền thông tin chi tiết của trình kết nối:

Tên: Globalping
URL: https://mcp.globalping.dev/mcp

Claude Code

Chạy lệnh sau trong terminal của bạn:

claude mcp add --transport http globalping https://mcp.globalping.dev/mcp

Để làm cho Globalping khả dụng trên tất cả các dự án trên máy của bạn (phạm vi người dùng toàn cầu) thay vì chỉ trong thư mục dự án hiện tại:

claude mcp add -s user --transport http globalping https://mcp.globalping.dev/mcp

Chạy claude mcp login globalping --no-browser nếu làm việc qua SSH hoặc trong terminal không có giao diện để hoàn tất trao đổi URL ủy quyền theo cách thủ công.

Cursor

Thêm Globalping vào Cursor chỉ với một cú nhấp chuột:

Hoặc cấu hình thủ công trong Cài đặt → Tính năng → Máy chủ MCP → Thêm máy chủ MCP mới:

Loại: SSE / HTTP
Tên: globalping
URL: https://mcp.globalping.dev/mcp

Gemini CLI

Globalping được lập chỉ mục trong Thư viện tiện ích mở rộng Gemini CLI chính thức.

Cài đặt qua trình quản lý tiện ích mở rộng Gemini:

gemini extensions install https://github.com/jsdelivr/globalping-mcp-server

(Thêm --auto-update để giữ cho tiện ích mở rộng được cập nhật tự động).

VS Code & GitHub Copilot

Bảng lệnh: Chạy MCP: Add Server và nhập https://mcp.globalping.dev/mcp.

Máy khách MCP chung

Đối với bất kỳ máy khách nào hỗ trợ giao thức truyền tải Streamable HTTP MCP tiêu chuẩn, hãy thêm:

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

Máy khách kế thừa (SSE / stdio dự phòng): Nếu máy khách của bạn yêu cầu nghiêm ngặt SSE qua cầu nối quy trình cục bộ, hãy cấu hình npx mcp-remote https://mcp.globalping.dev/sse.

Xác thực

Globalping MCP hỗ trợ hai chế độ xác thực:

OAuth 2.0: Được xử lý tự động trong các máy khách tương tác khi kết nối.
Mã API: Hữu ích cho các tập lệnh không có giao diện, đường ống CI/CD hoặc máy khách API lập trình.

Sử dụng mã API Globalping

Truy cập dash.globalping.io và tạo mã API trong mục Mã thông báo.
Truyền mã qua các tiêu đề HTTP tiêu chuẩn:

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

Tích hợp lập trình (Anthropic Messages API)

Để sử dụng Globalping trực tiếp với Anthropic Messages API (Trình kết nối MCP), hãy truyền định nghĩa máy chủ từ xa trong tải trọng yêu cầu của bạn:

{
  "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."
    }
  ]
}

Các công cụ khả dụng

Công cụ	Mô tả
`ping`	Thực hiện các bài kiểm tra ping ICMP/gói tin đến một đích
`traceroute`	Theo dõi các bước định tuyến mạng đến một mục tiêu
`dns`	Giải quyết các truy vấn DNS bằng các trình phân giải và loại bản ghi cụ thể
`mtr`	Chạy các bài kiểm tra ping và traceroute kết hợp (My Traceroute)
`http`	Thực hiện các yêu cầu HTTP/HTTPS từ các thiết bị đo trên toàn thế giới
`locations`	Liệt kê các vùng và bộ lọc thiết bị đo Globalping khả dụng
`limits`	Hiển thị hạn mức bài kiểm tra miễn phí theo giờ hiện tại và tín dụng bổ sung
`getMeasurement`	Truy xuất kết quả của một phép đo lịch sử theo ID
`compareLocations`	Hướng dẫn trợ giúp để so sánh các chỉ số hiệu suất đa vùng
`help`	Tài liệu tham khảo công cụ và cú pháp
`authStatus`	Kiểm tra trạng thái xác thực MCP hiện tại

Ví dụ sử dụng

Sau khi kết nối, hãy chạy các chẩn đoán mạng bằng ngôn ngữ tự nhiên:

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?

Chỉ định vị trí

Vị trí có thể được chỉ định bằng tham số magic của vị trí:

Châu lục: EU, NA, AS, AF, OC, SA
Mã quốc gia: US, DE, JP, PL, BR
Thành phố: London, Tokyo, New York, Warsaw
Mạng & ASN: Cloudflare, Google, AS13335, AS15169
Vùng đám mây: aws-us-east-1, gcp-us-central1
Kết hợp: London+UK, Cloudflare+US, AWS+Frankfurt

Khắc phục sự cố và hỗ trợ

Trình kết nối không thể truy cập máy chủ

Sử dụng điểm cuối Streamable HTTP chính xác như được hiển thị: https://mcp.globalping.dev/mcp.
Phản hồi 401 Unauthorized trước khi hoàn tất OAuth là điều bình thường. Kết nối lại tích hợp và hoàn tất quy trình ủy quyền trong trình duyệt.
Chỉ sử dụng điểm cuối /sse kế thừa cho các máy khách không hỗ trợ Streamable HTTP.

Xác thực thất bại hoặc hết hạn

Xóa và kết nối lại tích hợp để bắt đầu quy trình OAuth mới.
Đối với xác thực bằng mã API, hãy tạo mã hiện tại trong bảng điều khiển Globalping và gửi nó dưới dạng Authorization: Bearer YOUR_GLOBALPING_API_TOKEN.
Sau khi kết nối, hãy sử dụng công cụ authStatus để xác minh rằng xác thực đang hoạt động và công cụ limits để kiểm tra hạn mức bài kiểm tra miễn phí theo giờ và tín dụng khả dụng. Giới hạn tốc độ được hiển thị chỉ bao gồm các bài kiểm tra miễn phí; người dùng đã xác thực có tín dụng có thể tiếp tục vượt qua giới hạn đó bằng cách tiêu tốn một tín dụng cho mỗi bài kiểm tra bổ sung.

Nhận trợ giúp hoặc báo cáo sự cố

Đối với các câu hỏi sử dụng và lỗi có thể tái tạo, mở một vấn đề trên GitHub.
Đối với các báo cáo nhạy cảm về bảo mật, hãy sử dụng biểu mẫu Báo cáo lỗ hổng riêng tư của GitHub. Không bao gồm thông tin xác thực hoặc dữ liệu nhạy cảm trong một vấn đề công khai.
Chính sách quyền riêng tư và Điều khoản sử dụng của Globalping áp dụng cho dịch vụ này.

Phát triển

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

Thông tin xác thực & Bí mật

Lưu trữ thông tin xác thực OAuth:

npx wrangler secret put GLOBALPING_CLIENT_ID

Để xác minh miền thư mục plugin OpenAI, hãy lưu trữ mã được tạo bởi cổng gửi bài:

npx wrangler secret put OPENAI_APPS_CHALLENGE

Worker phục vụ giá trị này dưới dạng văn bản thuần túy từ /.well-known/openai-apps-challenge. Tuyến đường trả về 404 cho đến khi bí mật được cấu hình.

Thiết lập lưu trữ KV

Để quản lý trạng thái OAuth của Cloudflare Workers:

Tạo một không gian tên KV: npx wrangler kv:namespace create OAUTH_KV
Cấu hình OAUTH_KV bên trong wrangler.jsonc.