AI导哈

MCP协议调试工具

Reticle是一款用于实时拦截、可视化和分析MCP JSON-RPC流量的调试工具，支持多种传输协议，旨在实现微秒级开销。

  • by soth-ai
  • Rust
  • 本地部署
  • 124 星标
  • 更新于
在 GitHub 查看 LabTerminal/reticle

使用说明

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 <name> -- <command...>.

示例（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

文档

所有导游和深潜都在 GitHub维基:

CLI概述

命令 目的
mcp-reticle run 包装stdio MCP服务器并检查流量
mcp-reticle proxy 反向代理HTTP/SSE/Webocket传输
mcp-reticle ui 启动桌面用户界面
mcp-reticle daemon 无头遥测集线器

详细信息： CLI参考

安全与隐私

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

推荐阅读： 安全与隐私

贡献

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

许可证

麻省理工学院——见 LICENSE.

相关 MCP