Skip to main content

Real-time debugging proxy for MCP (Model Context Protocol) servers

Project description

mcp-reticle

The Wireshark for the Model Context Protocol

See what your Agent sees.

Reticle intercepts, visualizes, and profiles JSON-RPC traffic between your LLM and MCP servers in real-time — with zero latency overhead.

Installation

pip install mcp-reticle

Usage

Wrap your MCP server command with mcp-reticle run:

mcp-reticle run --name my-server -- python -m my_mcp_server

Claude Desktop Configuration

Edit ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "my-server": {
      "command": "mcp-reticle",
      "args": ["run", "--name", "my-server", "--", "python", "-m", "my_mcp_server"]
    }
  }
}

Features

  • Deep Packet Inspection — See raw JSON-RPC messages in real-time
  • Request/Response Correlation — Automatically links responses to requests
  • Latency Profiling — Color-coded latency indicators
  • Token Profiling — Real-time token estimation per message
  • Multi-Session Support — Debug multiple MCP servers simultaneously
  • Zero-Latency Proxy — Microsecond overhead

Documentation

Full documentation at github.com/labterminal/mcp-reticle

License

MIT

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_reticle-0.1.0rc6.tar.gz (15.6 MB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_reticle-0.1.0rc6-py3-none-any.whl (15.7 MB view details)

Uploaded Python 3

File details

Details for the file mcp_reticle-0.1.0rc6.tar.gz.

File metadata

  • Download URL: mcp_reticle-0.1.0rc6.tar.gz
  • Upload date:
  • Size: 15.6 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for mcp_reticle-0.1.0rc6.tar.gz
Algorithm Hash digest
SHA256 c9ea8c93e26d947385bbbfea75fd2279344ea8300ae82c15fee77b454ae39968
MD5 ce88314951c5dae5d06003adc20d92ef
BLAKE2b-256 b0c87f8e509b6332b0c54503e9fd426640cab1db8a5899108c57568d6338a526

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_reticle-0.1.0rc6.tar.gz:

Publisher: release.yml on LabTerminal/mcp-reticle

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mcp_reticle-0.1.0rc6-py3-none-any.whl.

File metadata

  • Download URL: mcp_reticle-0.1.0rc6-py3-none-any.whl
  • Upload date:
  • Size: 15.7 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.13.7

File hashes

Hashes for mcp_reticle-0.1.0rc6-py3-none-any.whl
Algorithm Hash digest
SHA256 a4d2e0c2764d1cbca22e67c667bb6b865a20449f76ed273560a9d5433ac856b4
MD5 4b7f30d55bf6a909832dd1b004ba48b6
BLAKE2b-256 b21c262fa23a5407ae5ace0ce10009cc5c2ed4e88bc76f62452d7aed7cae8b29

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_reticle-0.1.0rc6-py3-none-any.whl:

Publisher: release.yml on LabTerminal/mcp-reticle

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page