reticle (Lab Terminal)

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

______________________________________________________________________

什么是Reticle？

Reticle是一个用于调试MCP集成的代理+UI：

• 检查原始JSON-RPC消息（请求/通知/响应）
• 关联请求↔ 立即响应
• 配置文件延迟和令牌估计
• 捕获服务器stderr并崩溃
• 记录会话和导出日志

支持的传输： 标准, 可流式传输的HTTP, 双向通信, HTTP/SSE.

______________________________________________________________________

快速开始

1） 安装

# npm
npm install -g mcp-reticle

# pip
pip install mcp-reticle

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

2） 包装您的MCP服务器（stdio）

将MCP服务器命令替换为 mcp-reticle run --name -- .

示例（Claude Desktop样式配置）：

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

3） 启动用户界面

mcp-reticle ui

可选：仅日志模式（无UI）

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

可选：代理基于HTTP的MCP服务器

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

______________________________________________________________________

安装

如果您更喜欢从源代码构建：

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

______________________________________________________________________

文档

所有导游和深潜都在 :

• 入门
• CLI参考
• 客户端配置
• 故障排除
• 建筑
• 安全与隐私
• 发展
• 出口

______________________________________________________________________

CLI概述

详细信息： CLI参考

______________________________________________________________________

安全与隐私

Reticle可以捕获工具输入/输出和服务器stderr。将录制和导出视为 敏感 人工产品。

推荐阅读： 安全与隐私

______________________________________________________________________

贡献

• 回购指南： CONTRIBUTING.md
• 开发设置和命令： 发展指南

______________________________________________________________________

许可证

麻省理工学院——见 LICENSE.