麦普探测器

Name: 麦普探测器
Author: zabirauf

作者：zabirauf10 星标更新：2025-11-23

安装使用来源：spider==github.com

项目介绍

MCP Trace

一个强大的终端用户界面（TUI），用于实时监控和调试模型上下文协议（MCP）服务器。

MCP Trace TUI

为什么选择 MCP Trace？

在无法看到MCP服务器内部运行情况时，开发MCP服务器可能会变得具有挑战性。MCP Trace通过以下功能解决了这一问题：

主要特性

🔍 实时监控 - 观察客户端与服务器之间流动的JSON-RPC消息
📊 多服务器支持 - 在一个界面上同时监控多个MCP服务器
🎨 美观的TUI - 清晰直观的终端界面，带有表情符号指示器
📈 统计仪表板 - 跟踪请求、响应时间和错误率
🔎 智能过滤 - 按服务器、消息类型或搜索内容过滤日志
⚡ 零开销 - 对您的MCP服务器性能影响极小

🚀 快速开始

方案 1：通过脚本安装（推荐）

# macOS 和 Linux
curl --proto '=https' --tlsv1.2 -LsSf https://github.com/zabirauf/mcp-trace/releases/download/v0.2.0/mcp-trace-installer.sh | sh

方案 2：下载预构建二进制文件

从GitHub Releases下载适用于您平台的最新版本。

方案 3：从源代码构建

# 需要 Rust 1.70+
git clone https://github.com/zabirauf/mcp-trace
cd mcp-trace
cargo build --release

📖 基本用法

使用MCP Trace需要两个组件运行：

监视器 - 显示日志的TUI界面
代理 - 截获每个MCP服务器的通信

第一步：启动监视器

# 启动TUI监视器界面
mcp-trace monitor

第二步：为您的服务器启动代理

在另一个终端中：

# 基本用法
mcp-trace proxy --name "我的服务器" --command "python my_server.py"

🔧 配置您的MCP客户端

要在您的MCP客户端中使用MCP Trace，请更新配置文件（通常为mcp.json或cline_mcp_settings.json）：

{
  "mcpServers": {
    "my-server": {
      "command": "./mcp-proxy",
      "args": [
        "--name", "我的服务器", 
        "--command", "python path/to/my_server.py"
      ]
    }
  }
}

代理会透明地转发所有通信，并将日志记录到监视器。

📚 常见用法示例

Python MCP 服务器

# 简单的Python服务器
mcp-trace proxy --name "Python服务器" --command "python server.py"

# 使用虚拟环境
mcp-trace proxy --name "Python服务器" --command "venv/bin/python server.py"

# 带参数
mcp-trace proxy --name "Python服务器" --command "python server.py --port 3000"

Node.js MCP 服务器

# Node.js服务器
mcp-trace proxy --name "Node服务器" --command "node server.js"

# 使用npx
mcp-trace proxy --name "Node服务器" --command "npx @modelcontextprotocol/server-filesystem /path"

# 使用npm脚本
mcp-trace proxy --name "Node服务器" --command "npm run start:mcp"

多个服务器

同时监控多个MCP服务器：

# 终端1：启动监视器
mcp-trace monitor

# 终端2：Python服务器
mcp-trace proxy --name "Python API" --command "python api_server.py"

# 终端3：Node.js服务器
mcp-trace proxy --name "文件系统" --command "node fs_server.js"

# 终端4：另一个服务器
mcp-trace proxy --name "数据库" --command "./db_server"

🎮 键盘控制

动作

? - 显示上下文感知帮助
/ - 搜索日志
c - 清除所有日志
r - 刷新连接
q - 退出应用程序

滚动

PgUp/PgDn - 向上/向下翻页
Home/End - 跳转到顶部/底部

🐛 故障排除

监视器显示“无连接”

确保在启动代理之前监视器正在运行
检查两者是否使用相同的套接字路径（默认：/tmp/mcp-monitor.sock）
验证代理命令包含--name和--command标志

服务器无法启动

先直接测试您的服务器命令：python my_server.py
确保您的服务器使用STDIO进行MCP通信
使用--verbose标志检查代理日志

显示问题

将您的终端设置为支持256色：export TERM=xterm-256color
确保您的终端窗口至少为80x24字符
如果问题持续存在，尝试使用不同的终端模拟器

Contributing

我们欢迎贡献！该项目采用AI优先的开发方法，Claude和其他AI助手是主要的开发伙伴。

开发设置

git clone https://github.com/zabirauf/mcp-trace
cd mcp-trace
cargo build
cargo test