Globalping

공식

네트워크 접근 기능을 제공하며 ping, traceroute, mtr, http, dns resolve와 같은 명령어를 실행할 수 있습니다.

GitHub

Globalping MCP(으)로 무엇을 할 수 있나요?

전 세계 프로브에서 ping 테스트 실행 — 조수에게 특정 지역, 국가 또는 도시에서 ping을 사용하여 대상에 핑을 보내도록 요청하세요.
traceroute 또는 MTR로 네트워크 경로 추적 — 전 세계 프로브 위치에서 패킷이 이동하는 경로를 시각화하기 위해 traceroute 또는 mtr을 요청하세요.
모든 위치에서 DNS 레코드 조회 — 전 세계 프로브에서 사용자 정의 리졸버(예: Google DNS)를 사용하여 도메인을 확인하려면 dns를 사용하세요.
HTTP 연결 가능성 및 응답 시간 확인 — URL에 대해 http 테스트를 실행하여 여러 지역의 상태 코드, 타이밍 및 헤더를 측정하세요.
위치 간 네트워크 성능 비교 — compareLocations 가이드를 사용하여 측정을 나란히 실행하고 대상 간 지연 시간 또는 라우팅을 대조하세요.
과거 측정값 검색 및 속도 제한 확인 — getMeasurement로 ID별 이전 결과를 가져오거나 limits를 통해 현재 API 제한을 확인하세요.

문서

Globalping MCP 서버

AI 모델이 자연어를 통해 글로벌 네트워크 측정 플랫폼과 상호 작용할 수 있도록 합니다. 모든 LLM에 네트워크 접근 권한을 부여하세요.

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 클라이언트가 측정 유형과 옵션을 지능적으로 선택할 수 있도록 상세한 매개변수 설명 제공
🔄 비교 분석: 서로 다른 대상 간의 네트워크 성능 비교 가능
🔑 인증 지원: 더 높은 속도 제한을 위해 Globalping 계정으로 OAuth 또는 API 토큰 사용

설치

원격 MCP 서버는 다음 엔드포인트에서 사용할 수 있습니다:

Streamable HTTP 전송: https://mcp.globalping.dev/mcp
SSE 전송: https://mcp.globalping.dev/sse

모델 컨텍스트 프로토콜을 지원하는 다양한 AI 도구에 Globalping MCP 서버를 통합할 수 있습니다.

다음은 가장 인기 있는 3가지 도구에 대한 안내입니다:

Gemini CLI

Gemini CLI에 Globalping MCP 서버를 추가하려면:

Gemini CLI가 설치되어 있는지 확인하세요.
다음 명령어를 실행하세요:

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 (콘솔 사용)

Anthropic 콘솔에서 Claude 어시스턴트를 생성할 때:

console.anthropic.com으로 이동합니다.
어시스턴트 섹션으로 이동합니다.
새 어시스턴트를 생성하거나 기존 어시스턴트를 편집합니다.
도구 섹션에서 "사용자 정의 도구 추가"를 선택합니다.
다음 세부 정보를 입력합니다:
- 도구 이름: Globalping
- 설명: Run network tests from locations worldwide
- 도구 URL: https://mcp.globalping.dev/mcp (Streamable HTTP 전송) 또는 https://mcp.globalping.dev/sse (SSE 전송)

Cursor

Cursor에 Globalping MCP 서버를 추가하려면:

Cursor 설정을 엽니다.
도구 및 MCP 탭으로 이동합니다.
"+ 새 MCP 서버"를 클릭합니다.
mcp.json 구성 파일이 열리면 다음을 추가해야 합니다:

Streamable HTTP 전송:

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

레거시 SSE 전송:

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

저장하고 Cursor를 다시 시작합니다.

인증

Globalping MCP 서버는 두 가지 인증 방법을 지원합니다:

OAuth 인증: 안전한 접근을 위해 서버에서 자동으로 처리
API 토큰 인증: Authorization 헤더를 통한 수동 토큰 구성

두 방법 모두 더 높은 속도 제한과 프로브 네트워크에 대한 우선 접근을 제공합니다.

Globalping API 토큰 사용

서버는 Authorization 헤더에 API 토큰이 제공되면 이를 자동으로 감지하여 OAuth 대신 인증에 사용합니다.

API 토큰 얻기

dash.globalping.io를 방문합니다.
계정에 로그인합니다.
토큰으로 이동하여 새 API 토큰을 생성합니다.

인증 구성

Streamable 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 호환 AI 어시스턴트와 함께 MCP 서버를 사용할 수 있습니다:

Claude 데스크톱
Anthropic 어시스턴트
Cursor
Windsurf
MCP 프로토콜의 모든 사용자 정의 구현

클라이언트를 이 서버에 연결하는 방법에 대한 자세한 내용은 사용 중인 도구의 MCP 문서를 참조하세요.

사용 가능한 도구

ping - 대상에 대한 ping 테스트 수행
traceroute - 대상에 대한 traceroute 테스트 수행
dns - 도메인에 대한 DNS 조회 수행
mtr - 대상에 대한 MTR(My Traceroute) 테스트 수행
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을(를) 구성합니다.