Globalping

Máy chủ Globalping MCP

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. 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 đầu dò phân bố toàn cầu để giám sát, gỡ lỗi và đo điểm chuẩn 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 địa điểm trên toàn thế giới.

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

Máy chủ Globalping MCP triển khai Giao thức Ngữ cảnh Mô hình (MCP), cho phép các mô hình AI như GPT của OpenAI và Claude của Anthropic 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.

Nó cũng hỗ trợ hai phương thức xác thực: OAuth và xác thực bằng mã thông báo API. Cả hai phương thức đều cung cấp cách an toàn để tương tác với API của chúng tôi và cung cấp giới hạn tốc độ cao hơn gắn với tài khoản của bạn.

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 đầu dò 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 sẽ dễ dàng phân tích dữ liệu và chạy các phép đo mới khi cần
• 📊 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: Cung cấp mô tả tham số chi tiết để các ứng dụng khách AI lựa chọn thông minh loại phép đo và tùy chọn
• 🔄 Phân tích so sánh: Cho phép so sánh hiệu suất mạng giữa các mục tiêu khác nhau
• 🔑 Hỗ trợ xác thực: Sử dụng OAuth hoặc mã thông báo 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

Máy chủ MCP từ xa có sẵn tại các điểm cuối sau:

• Truyền tải HTTP có thể truyền phát: https://mcp.globalping.dev/mcp
• Truyền tải SSE: https://mcp.globalping.dev/sse

Bạn có thể tích hợp máy chủ Globalping MCP của chúng tôi với nhiều công cụ AI khác nhau hỗ trợ Giao thức Ngữ cảnh Mô hình.

Dưới đây là hướng dẫn cho 3 công cụ phổ biến nhất:

Gemini CLI

Để thêm máy chủ Globalping MCP vào Gemini CLI:

1. Đảm bảo bạn đã cài đặt Gemini CLI.
2. Chạy lệnh sau:

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

Thao tác này sẽ tự động cấu hình máy chủ với xác thực OAuth được bật. Bạn sẽ được nhắc đăng nhập khi sử dụng tiện ích mở rộng lần đầu tiên.

Lưu ý: Nếu bạn muốn sử dụng mã thông báo API Globalping (để có giới hạn tốc độ cao hơn hoặc tự động hóa), bạn có thể thêm máy chủ thủ công với tiêu đề Ủy quyền thay vì sử dụng trình cài đặt tiện ích mở rộng:

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

Ứng dụng Claude Desktop

Thêm vào tệp cấu hình Claude Desktop của bạn (nằm tại %APPDATA%\Claude\config.json trên Windows hoặc ~/Library/Application Support/Claude/config.json trên macOS):

[!note] Claude Desktop chỉ hỗ trợ nguyên bản truyền tải stdio cho các máy chủ MCP cục bộ. Đối với máy chủ MCP từ xa, hãy sử dụng cầu nối mcp-remote.

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

API Claude của Anthropic (qua Console)

Khi tạo Trợ lý Claude trong Anthropic Console:

1. Truy cập console.anthropic.com
2. Điều hướng đến phần Trợ lý
3. Tạo Trợ lý mới hoặc chỉnh sửa trợ lý hiện có
4. Trong phần Công cụ, chọn "Thêm công cụ tùy chỉnh"
5. Nhập các chi tiết sau:
   • Tên công cụ: Globalping
   • Mô tả: Run network tests from locations worldwide
   • URL công cụ: https://mcp.globalping.dev/mcp (truyền tải HTTP có thể truyền phát) hoặc https://mcp.globalping.dev/sse (truyền tải SSE)

Cursor

Để thêm máy chủ Globalping MCP vào Cursor:

1. Mở cài đặt Cursor
2. Điều hướng đến tab Công cụ & MCP
3. Nhấp vào "+ Máy chủ MCP mới"
4. Thao tác này sẽ mở tệp cấu hình mcp.json, nơi bạn sẽ cần thêm:

Truyền tải HTTP có thể truyền phát:

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

Truyền tải SSE cũ:

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

5. Lưu và khởi động lại Cursor

Xác thực

Máy chủ Globalping MCP hỗ trợ hai phương thức xác thực:

• Xác thực OAuth: Được máy chủ tự động xử lý để truy cập an toàn
• Xác thực bằng mã thông báo API: Cấu hình mã thông báo thủ công qua tiêu đề Ủy quyền

Cả hai phương thức đều cung cấp giới hạn tốc độ cao hơn và quyền truy cập ưu tiên vào mạng lưới đầu dò.

Sử dụng mã thông báo API Globalping

Máy chủ tự động phát hiện khi mã thông báo API được cung cấp trong tiêu đề Ủy quyền và sử dụng nó để xác thực thay vì OAuth.

Lấy mã thông báo API của bạn

1. Truy cập dash.globalping.io
2. Đăng nhập vào tài khoản của bạn
3. Điều hướng đến Mã thông báo để tạo mã thông báo API mới

Cấu hình với xác thực

Truyền tải HTTP có thể truyền phát:

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

Truyền tải SSE cũ:

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

Kết nối trợ lý AI

Bạn có thể sử dụng máy chủ MCP của chúng tôi với bất kỳ trợ lý AI tương thích MCP nào, bao gồm:

• Claude Desktop
• Trợ lý Anthropic
• Cursor
• Windsurf
• Bất kỳ triển khai tùy chỉnh nào của giao thức MCP

Xem tài liệu MCP của công cụ bạn để biết chi tiết về cách kết nối ứng dụng khách với máy chủ này.

Công cụ có sẵn

• ping - Thực hiện kiểm tra ping đến mục tiêu
• traceroute - Thực hiện kiểm tra traceroute đến mục tiêu
• dns - Thực hiện tra cứu DNS cho một tên miền
• mtr - Thực hiện kiểm tra MTR (My Traceroute) đến mục tiêu
• http - Thực hiện yêu cầu HTTP đến một URL
• locations - Liệt kê tất cả các vị trí đầu dò Globalping có sẵn
• limits - Hiển thị giới hạn tốc độ hiện tại của bạn cho API Globalping
• getMeasurement - Truy xuất phép đo đã chạy trước đó theo ID
• compareLocations - Hướng dẫn cách chạy các phép đo so sánh
• help - Hiển thị thông báo trợ giúp với tài liệu về các công cụ có sẵn

Ví dụ sử dụng

Sau khi kết nối với mô hình AI thông qua ứng dụng khách MCP tương thích, bạn có thể tương tác với Globalping 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?

Đặc tả vị trí

Vị trí có thể được chỉ định bằng trường "magic", hỗ trợ nhiều định dạng khác nhau:

• Mã lục địa: "EU", "NA", "AS", v.v.
• Mã quốc gia: "US", "DE", "JP", v.v.
• Tên thành phố: "London", "Tokyo", "New York", v.v.
• Tên mạng: "Cloudflare", "Google", v.v.
• Số ASN: "AS13335", "AS15169", v.v.
• Khu vực nhà cung cấp đám mây: "aws-us-east-1", "gcp-us-central1", v.v.

Bạn cũng có thể kết hợp chúng với dấu cộng để nhắm mục tiêu cụ thể hơn: "London+UK", "Cloudflare+US", v.v.

Phát triển

Cơ sở mã được tổ chức thành các mô-đun:

• src/index.ts - Điểm vào chính và định nghĩa tác nhân MCP
• src/app.ts - Các tuyến web OAuth
• src/api - Ứng dụng khách API Globalping
• src/auth - Tiện ích xác thực
• src/config - Cấu hình và hằng số
• src/lib - Hàm tiện ích
• src/mcp - Trình xử lý công cụ MCP
• src/types - Định nghĩa kiểu TypeScript
• src/ui - Mẫu HTML

Thêm thông tin xác thực Globalping

Thêm thông tin xác thực OAuth của Globalping:

• npx wrangler secret put GLOBALPING_CLIENT_ID

Lưu trữ KV

Được sử dụng cho tài liệu OAuthProvider https://github.com/cloudflare/workers-oauth-provider

• tạo không gian tên KV và sao chép ID
• ràng buộc cho nó phải là OAUTH_KV
• cấu hình kv_namespaces trong tệp wrangler.jsonc