ProbeOps
Diagnóstico de rede de 6 regiões globais — SSL, DNS, ping, whois, traceroute, varredura de portas, latência. Funciona sem chave de API.
Documentação
Servidor MCP ProbeOps
Servidor MCP para executar diagnósticos de infraestrutura a partir de 6 regiões globais. Verificações SSL, consultas DNS, ping, whois, verificações de porta, traceroute, testes de latência e mais — cada um executado simultaneamente a partir do Leste dos EUA, Oeste dos EUA, Europa Central, Canadá, Índia e Austrália.
Funciona instantaneamente — nenhuma chave de API necessária. Execute npx @probeops/mcp-server e obtenha 11 ferramentas de diagnóstico com 10 chamadas gratuitas por dia. Adicione uma chave de API para desbloquear todas as 21 ferramentas, 6 regiões e limites maiores.
Funciona com Claude Code, Codex, Cursor, Windsurf, Cline e qualquer cliente compatível com Model Context Protocol.
Início Rápido
Opção 1: Experimente Agora (Sem Chave de API)
Claude Code:
claude mcp add probeops -- npx -y @probeops/mcp-server
Codex:
codex mcp add probeops -- npx -y @probeops/mcp-server
Cursor / Windsurf / Cline (adicione ao .mcp.json ou à configuração MCP do seu cliente):
{
"mcpServers": {
"probeops": {
"command": "npx",
"args": ["-y", "@probeops/mcp-server"]
}
}
}
É isso. Você obtém 11 ferramentas com 10 chamadas por dia e 2 regiões de sondagem — sem cadastro, sem configuração.
Opção 2: Acesso Completo (Chave de API Gratuita)
Cadastre-se em probeops.com e crie uma chave de API no painel. Em seguida, adicione-a à sua configuração:
Claude Code:
claude mcp add probeops -e PROBEOPS_API_KEY=your-key -- npx -y @probeops/mcp-server
Codex (adicione ao ~/.codex/config.toml):
[mcp_servers.probeops]
command = "npx"
args = ["-y", "@probeops/mcp-server"]
[mcp_servers.probeops.env]
PROBEOPS_API_KEY = "your-api-key-here"
Cursor / Windsurf / Cline:
{
"mcpServers": {
"probeops": {
"command": "npx",
"args": ["-y", "@probeops/mcp-server"],
"env": {
"PROBEOPS_API_KEY": "your-api-key-here"
}
}
}
}
Modo Demo vs Acesso Completo
| Modo Demo (sem chave) | Nível Gratuito (com chave) | Profissional | |
|---|---|---|---|
| Ferramentas | 11 | 21 | 21 |
| Chamadas por dia | 10 | 100 | 5.000 |
| Regiões por chamada | 2 | 4 | 6 |
| Navegação geo-proxy | — | 3 horas/dia | 10 horas/dia |
| Tempo de configuração | 0 min | 2 min | 2 min |
O Que Você Obtém
21 ferramentas de diagnóstico de infraestrutura, cada uma executando a partir de até 6 regiões simultaneamente. Além de navegação geo-proxy e gerenciamento de conta.
Cada chamada de ferramenta de diagnóstico retorna resultados por região e um rodapé de cota mostrando o uso restante.
Ferramentas de Diagnóstico (14)
| Ferramenta | O que faz | Exemplo de entrada |
|---|---|---|
ssl_check | Validade do certificado SSL/TLS, expiração, emissor, versão TLS, SANs, consistência entre regiões | { "domain": "example.com" } |
dns_lookup | Consulta de registros DNS (A, AAAA, CNAME, MX, TXT, NS, SOA, CAA, PTR) com verificação de propagação em múltiplas regiões | { "domain": "example.com", "record_type": "MX" } |
is_it_down | Status do site online/offline/parcial a partir de múltiplas regiões | { "url": "https://example.com" } |
latency_test | Latência HTTP (TTFB) a partir de múltiplas regiões, retorna mín/méd/máx | { "target": "example.com" } |
traceroute | Rastreamento de caminho de rede com latência por salto. TCP, UDP ou ICMP | { "target": "example.com", "protocol": "tcp" } |
port_check | Verificação de porta aberta/fechada/filtrada a partir de múltiplas regiões | { "target": "example.com", "port": 443 } |
ping | Ping ICMP com perda de pacotes e tempos de ida e volta | { "target": "8.8.8.8" } |
whois | Informações de registro de domínio: registrador, datas, servidores de nomes | { "domain": "example.com" } |
nmap_port_check | Verifica múltiplas portas abertas/fechadas usando nmap (não é uma varredura completa) | { "target": "example.com", "ports": "80,443" } |
tcp_ping | Latência em nível TCP para uma porta específica (funciona quando o ICMP está bloqueado) | { "target": "example.com", "port": 443 } |
keyword_check | Verifica se uma palavra-chave existe em uma página web a partir de múltiplas regiões | { "url": "https://example.com", "keyword": "pricing" } |
websocket_check | Verificação de conectividade de endpoint WebSocket | { "url": "wss://example.com/ws" } |
banner_grab | Detecção de banner/versão de serviço em uma porta | { "target": "example.com", "port": 22 } |
api_health | Verificação de saúde de endpoint de API (status HTTP, tempo de resposta, disponibilidade) | { "url": "https://api.example.com/health" } |
Atalhos de DNS
Estes chamam dns_lookup com um record_type predefinido para que você não precise lembrar os nomes dos tipos de registro:
| Ferramenta | Equivalente a |
|---|---|
mx_lookup | dns_lookup com record_type: "MX" |
txt_lookup | dns_lookup com record_type: "TXT" |
ns_lookup | dns_lookup com record_type: "NS" |
cname_lookup | dns_lookup com record_type: "CNAME" |
caa_lookup | dns_lookup com record_type: "CAA" |
reverse_dns_lookup | dns_lookup com record_type: "PTR" (aceita um endereço IP) |
Navegação Geo-Proxy
| Ferramenta | O que faz | Exemplo de entrada |
|---|---|---|
get_geo_proxy | Obtenha credenciais de proxy para uma região. Use com Playwright ou qualquer cliente de proxy HTTPS | { "region": "eu-central" } |
geo_browse | Navegue em uma URL a partir de uma região usando um navegador real. Retorna conteúdo da página e/ou captura de tela | { "url": "https://example.com", "region": "ap-south" } |
Conta
| Ferramenta | O que faz |
|---|---|
account_status | Uso atual da cota (minuto/hora/dia/mês), nível de assinatura, token de proxy ativo |
Recursos
| URI | Descrição |
|---|---|
probeops://regions | Regiões de sondagem com localização, país e contagem de nós |
probeops://proxy-regions | Regiões de geo-proxy com FQDNs e URLs de proxy |
probeops://usage | Uso atual da API, cota restante, status do token ativo |
Regiões Globais
Todas as ferramentas de diagnóstico são executadas a partir destas 6 regiões simultaneamente:
| Código da Região | Localização | País |
|---|---|---|
us-east | Ashburn, Virgínia | Estados Unidos |
us-west | Boardman, Oregon | Estados Unidos |
eu-central | Helsinque | Finlândia |
ca-central | Montreal | Canadá |
ap-south | Mumbai | Índia |
ap-southeast | Sydney | Austrália |
Gerenciamento de Token Geo-Proxy
O servidor gerencia tokens de proxy automaticamente:
| Estado do Token | Ação | Custo de Cota |
|---|---|---|
| > 5 min restantes | Reutilizar token em cache | 0 |
| 0-5 min restantes | Estender automaticamente +1 hora | 1 unidade |
| Expirado ou sem token | Gerar novo token | 1 unidade |
- Um único token funciona em todas as 6 regiões. Alternar regiões não consome cota.
- Cota diária = total de horas de navegação por proxy por dia.
- A cota é redefinida à meia-noite UTC.
Exemplos de Saída
Verificação SSL
ssl_check({ domain: "github.com" })
SSL Certificate Report for github.com
Status: VALID
Subject: github.com
Issuer: DigiCert (DigiCert Inc)
Expires in: 245 days
TLS: TLSv1.3 (TLS_AES_256_GCM_SHA384)
Region Results:
| Region | Location | Status | Time |
|--------|----------|--------|------|
| us-east | Ashburn | OK | 45ms |
| eu-central | Helsinki | OK | 38ms |
| ap-south | Mumbai | OK | 112ms |
| us-west | Boardman | OK | 52ms |
| ca-central | Montreal | OK | 41ms |
| ap-southeast | Sydney | OK | 98ms |
Completed in 125ms
---
Diagnostics: 97 of 100 remaining today (Free)
Ping
ping({ target: "1.1.1.1" })
Ping: 1.1.1.1
ap-south (Mumbai):
PING 1.1.1.1 (1.1.1.1) 56(84) bytes of data.
64 bytes from 1.1.1.1: icmp_seq=1 ttl=56 time=1.35 ms
3 packets transmitted, 3 received, 0% packet loss
rtt min/avg/max/mdev = 1.353/1.398/1.474/0.054 ms
Response time: 2147ms
eu-central (Helsinki):
PING 1.1.1.1 (1.1.1.1) 56(84) bytes of data.
64 bytes from 1.1.1.1: icmp_seq=1 ttl=54 time=21.2 ms
3 packets transmitted, 3 received, 0% packet loss
rtt min/avg/max/mdev = 20.651/20.941/21.217/0.231 ms
Response time: 2031ms
...
Completed in 2332ms
---
Diagnostics: 96 of 100 remaining today (Free)
Whois
whois({ domain: "example.com" })
Whois: example.com
us-east (Ashburn):
Domain Name: EXAMPLE.COM
Registry Domain ID: 2336799_DOMAIN_COM-VRSN
Registrar: RESERVED-Internet Assigned Numbers Authority
Creation Date: 1995-08-14T04:00:00Z
Registry Expiry Date: 2025-08-13T04:00:00Z
Name Server: A.IANA-SERVERS.NET
Name Server: B.IANA-SERVERS.NET
DNSSEC: signedDelegation
Response time: 734ms
...
Completed in 852ms
---
Diagnostics: 95 of 100 remaining today (Free)
Variáveis de Ambiente
| Variável | Obrigatória | Padrão | Descrição |
|---|---|---|---|
PROBEOPS_API_KEY | Não | - | Sua chave de API ProbeOps (obtenha uma gratuitamente). Sem ela, executa em modo demo (11 ferramentas, 10 chamadas/dia) |
PROBEOPS_BASE_URL | Não | https://probeops.com | URL base da API (para instâncias de staging ou auto-hospedadas) |
Limites de Taxa
| Gratuito | Padrão | Profissional | |
|---|---|---|---|
| Por minuto | 15 | 30 | 50 |
| Por hora | 100 | 500 | 2.000 |
| Por dia | 100 | 1.000 | 5.000 |
| Por mês | 500 | 20.000 | 100.000 |
| Concorrentes | 3 | 5 | 10 |
| Horas de proxy/dia | 3 | 5 | 10 |
| Regiões | 4 de 6 | Todas as 6 | Todas as 6 |
O nível gratuito não exige cartão de crédito. Verifique o uso a qualquer momento com account_status.
Consulte probeops.com/pricing para obter detalhes atuais.
Desenvolvimento
git clone https://github.com/kumarprobeops/probeops-mcp-server.git
cd probeops-mcp-server
npm install
npm run build
Teste localmente:
PROBEOPS_API_KEY=your-key node dist/index.js
Requisitos
- Node.js >= 18.0.0
- Playwright (opcional) - necessário apenas para capturas de tela do
geo_browse
Sem Playwright,npx playwright install chromiumgeo_browseusa HTTP fetch como fallback (HTML bruto, sem capturas de tela).
Perguntas Frequentes
P: Como isso é diferente de executar curl ou dig localmente?
Cada verificação é executada a partir de 6 regiões globais simultaneamente. Você vê propagação de DNS, latência e disponibilidade da perspectiva de usuários reais em todo o mundo, não da sua rede local.
P: Preciso instalar algo além do Node.js?
Não. npx -y @probeops/mcp-server cuida de tudo. Playwright é opcional (apenas para capturas de tela do geo_browse).
P: Posso usar isso em pipelines de CI/CD?
Sim. Defina PROBEOPS_API_KEY como uma variável de ambiente e chame o servidor MCP a partir de qualquer ferramenta compatível com MCP.
P: A chave de API é enviada com segurança?
Sim. Toda a comunicação usa HTTPS. A chave é enviada pelo cabeçalho X-API-Key, nunca em URLs ou logs.
Licença
MIT - consulte LICENSE