soth-ai/mcp-reticle

ПРИЦЕЛ

Wireshark для протокола контекста модели (MCP)

Смотри, что видит твой агент.

Прицел перехватывает, визуализирует и профилирует трафик MCP JSON-RPC в реальном времени — рассчитанный на микросекундные накладные расходы.

Быстрый старт · Установка · Документы · Безопасность · Вклад

---

Что такое прицел?

Reticle — это прокси + интерфейс для отладки интеграций MCP:

• инспектировать необработанные JSON-RPC-сообщения (запросы / уведомления / ответы)
• корреляция ответа на запрос ↔ мгновенно
• Задержка профиля и оценки токенов
• Захват сервера STDERR и сбои
• запись сессий и журналы экспорта

Поддерживаемые транспорты: stdio, Streamable HTTP, WebSocket, HTTP/SSE.

---

Быстрый старт

1) Установка

2) Оберните ваш MCP-сервер (stdio)

Замените команду сервера MCP на mcp-reticle run --name -- .

Пример (конфигурация в стиле Claude Desktop):

3) Запустить интерфейс

Опционально: режим только журнала (без интерфейса)

Опционально: прокси MCP-сервера на базе HTTP

---

Установка

Если предпочитаете строить из источника:

---

Документация

Все гайды и подробные исследования доступны на GitHub Wiki:

• Начало
• Справочник CLI
• Конфигурация клиента

RETICLE

The Wireshark for the Model Context Protocol (MCP)

See what your agent sees.

Reticle intercepts, visualizes, and profiles MCP JSON-RPC traffic in real time — designed for microsecond-level overhead.

Quick start · Install · Docs · Security · Contributing

---

What is Reticle?

Reticle is a proxy + UI for debugging MCP integrations:

• inspect raw JSON-RPC messages (requests / notifications / responses)
• correlate request ↔ response instantly
• profile latency and token estimates
• capture server stderr and crashes
• record sessions and export logs

Supported transports: stdio, Streamable HTTP, WebSocket, HTTP/SSE.

---

Quick start

1) Install

# npm
npm install -g mcp-reticle

# pip
pip install mcp-reticle

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

2) Wrap your MCP server (stdio)

Replace your MCP server command with mcp-reticle run --name -- .

Example (Claude Desktop-style config):

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

3) Launch the UI

mcp-reticle ui

Optional: log-only mode (no UI)