MCP Reticle

RETICLE

O Wireshark para o Model Context Protocol (MCP)

Veja o que seu agente vê.

O Reticle intercepta, visualiza e analisa o tráfego JSON-RPC do MCP em tempo real — projetado para sobrecarga em nível de microssegundos.

Início rápido · Instalação · Documentação · Segurança · Contribuição

---

O que é o Reticle?

O Reticle é um proxy + interface para depurar integrações MCP:

• inspecione mensagens JSON-RPC brutas (solicitações / notificações / respostas)
• correlacione solicitação ↔ resposta instantaneamente
• analise latência e estimativas de tokens
• capture stderr e falhas do servidor
• grave sessões e exporte logs

Transportes suportados: stdio, Streamable HTTP, WebSocket, HTTP/SSE.

---

Início rápido

1) Instalação

# npm
npm install -g mcp-reticle

# pip
pip install mcp-reticle

# Homebrew
brew install labterminal/mcp-reticle/mcp-reticle

2) Envolva seu servidor MCP (stdio)

Substitua o comando do seu servidor MCP por mcp-reticle run --name <name> -- <command...>.

Exemplo (configuração estilo Claude Desktop):

{
  "mcpServers": {
    "filesystem": {
      "command": "mcp-reticle",
      "args": ["run", "--name", "filesystem", "--", "npx", "-y", "@modelcontextprotocol/server-filesystem", "/Users/me/work"]
    }
  }
}

3) Inicie a interface

mcp-reticle ui

Opcional: modo somente log (sem interface)

mcp-reticle run --log -- npx -y @modelcontextprotocol/server-memory

Opcional: proxy para um servidor MCP baseado em HTTP

mcp-reticle proxy --name api --upstream http://localhost:8080 --listen 3001

---

Instalação

Se preferir compilar a partir do código-fonte:

git clone https://github.com/labterminal/mcp-reticle.git
cd mcp-reticle
just build

---

Documentação

Todos os guias e aprofundamentos estão na Wiki do GitHub:

• Começando
• Referência da CLI
• Configuração do cliente
• Solução de problemas
• Arquitetura
• Segurança e privacidade
• Desenvolvimento
• Exportações

---

Visão geral da CLI

Comando	Finalidade
mcp-reticle run	Envolva servidores MCP stdio e inspecione o tráfego
mcp-reticle proxy	Proxy reverso para transportes HTTP/SSE/WebSocket
mcp-reticle ui	Inicie a interface desktop
mcp-reticle daemon	Hub de telemetria headless

Detalhes completos: Referência da CLI

---

Segurança e privacidade

O Reticle pode capturar entradas/saídas de ferramentas e stderr do servidor. Trate gravações e exportações como artefatos sensíveis.

Leitura recomendada: Segurança e privacidade

---

Contribuição

• Diretrizes do repositório: CONTRIBUTING.md
• Configuração de desenvolvimento e comandos: Guia de desenvolvimento

---

Licença

MIT — veja LICENSE.