Globalping

공식

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

GitHub

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

네트워크 진단 실행 — 특정 글로벌 위치에서 임의의 대상으로 ping, traceroute, mtr 또는 http 테스트를 요청하세요.
DNS 쿼리 해석 — dns 도구를 사용하여 Google DNS(8.8.8.8)와 같은 사용자 지정 리졸버를 통해 레코드를 확인하세요.
다중 지역 성능 비교 — compareLocations를 활용하여 대륙 또는 도시 간 지연 시간과 라우팅을 벤치마킹하세요.
과거 결과 검색 — 감사 또는 분석을 위해 getMeasurement로 ID별 과거 측정 데이터를 가져오세요.
계정 상태 확인 — authStatus 및 limits를 사용하여 인증을 확인하고 시간당 테스트 허용량을 검토하세요.
프로브 위치 탐색 — locations를 쿼리하여 타겟팅에 사용 가능한 지역, 네트워크 및 클라우드 제공업체를 나열하세요.

문서

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 (웹 및 데스크톱)

ChatGPT에서 설정 → 보안 및 로그인으로 이동하여 개발자 모드를 활성화합니다 (또는 ChatGPT 데스크톱에서 설정 → 기능 → MCP 서버).
다음 엔드포인트로 새 사용자 지정 커넥터 / MCP 서버를 추가합니다:

https://mcp.globalping.dev/mcp

프롬프트가 표시되면 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 (웹, 데스크톱)

Claude는 로컬 mcp-remote 브리지 없이 원격 Streamable HTTP MCP 커넥터를 기본적으로 지원합니다:

Claude에서 설정 → 커넥터로 이동합니다 (팀/엔터프라이즈 계정의 경우 조직 설정 → 커넥터).
+ 사용자 지정 커넥터 추가를 클릭합니다.
커넥터 세부 정보를 입력합니다:

이름: 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

한 번의 클릭으로 Cursor에 Globalping을 추가합니다:

또는 설정 → 기능 → MCP 서버 → 새 MCP 서버 추가에서 수동으로 구성:

유형: SSE / HTTP
이름: globalping
URL: https://mcp.globalping.dev/mcp

Gemini CLI

Globalping은 공식 **Gemini CLI 확장 갤러리**에 등록되어 있습니다.

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는 두 가지 인증 모드를 지원합니다:

OAuth 2.0: 연결 중 대화형 클라이언트에서 자동으로 처리됩니다.
API 토큰: 헤드리스 스크립트, CI/CD 파이프라인 또는 프로그래밍 방식 API 클라이언트에 유용합니다.

Globalping API 토큰 사용

dash.globalping.io로 이동하여 토큰 아래에서 API 토큰을 생성합니다.
표준 HTTP 헤더를 통해 토큰을 전달합니다:

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

프로그래밍 방식 통합 (Anthropic Messages API)

Anthropic의 Messages API(MCP 커넥터)와 함께 Globalping을 직접 사용하려면 요청 페이로드에 원격 서버 정의를 전달합니다:

{
  "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`	현재 무료 시간당 테스트 허용량 및 추가 크레딧 표시
`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개를 사용하여 한도 이상으로 계속 사용할 수 있습니다.

도움 요청 또는 문제 보고

사용 관련 질문과 재현 가능한 버그는 GitHub 이슈 열기를 사용하세요.
보안 관련 보고는 GitHub의 비공개 취약점 보고 양식을 사용하세요. 공개 이슈에 자격 증명이나 민감한 데이터를 포함하지 마세요.
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 상태 관리를 위해:

KV 네임스페이스 생성: npx wrangler kv:namespace create OAUTH_KV
wrangler.jsonc 내부에서 OAUTH_KV을 구성합니다.