MCP代理跟踪检查器
npm mcp-agent-trace-inspector 包裹
本地优先，代理工作流的MCP本地可观察性。每个工具调用、提示转换、延迟和令牌计数都记录在本地SQLite数据库中-没有云帐户，没有API密钥，没有留下机器的痕迹。专为MCP构建，而不是固定在通用LLM代理上。
主要特点
- 工具调用跟踪：捕获工作流中每个步骤的输入、输出、延迟和令牌使用情况。
- 持久存储：会话重新启动后痕迹仍然存在；本地存储在SQLite中，没有外部依赖关系。
- HTML仪表板：生成一个包含交互式步骤时间线的独立单文件仪表板。
- 代币成本估算：使用可配置的模型定价表计算每个跟踪的美元成本-不需要API调用。
- 跟踪比较：并排区分两条轨迹，以衡量提示或工具更改的影响。
- 低开销：每一步增加不到5ms；永远不会成为瓶颈。
为什么是LangSmith/AgentOps？
| mcp代理跟踪检查员 | LangSmith/AgentOps | |
|---|---|---|
| 数据位置 | 本地SQLite——永远不会离开你的机器 | 云托管；发送到外部服务器的跟踪 |
| 安装程序 | npx 一行，零配置 | 帐户注册，API密钥，SDK工具 |
| MCP感知 | 原生——将工具调用记录为一级步骤 | 通用LLM代理；MCP结构不透明 |
| 运行差异 | 内置 compare_traces diff | 单独付费功能或手动导出 |
| 成本估算 | 离线tiktoken+可配置定价表 | 需要通过其代理的API实时流量 |
| 开销 | 每步\<5ms | 每个事件的网络往返 |
如果您的跟踪包含敏感的工具输出、专有提示或必须保留在设备上的数据，那么这是正确的工具。如果您需要跨团队跟踪共享或托管SaaS，请使用LangSmith。
免责声明
mcp-agent-trace-inspector 在SQLite数据库中本地存储工具调用输入和输出。跟踪可能包含传递到工具或从工具返回的敏感信息。在共享仪表板导出之前，请先查看跟踪内容。痕迹不会自动传输；可选的alert webhooks可用。
需求
- Node.js v22.5.0或更新版本。
- npm。
入门
将以下配置添加到MCP客户端：
{
"mcpServers": {
"trace-inspector": {
"command": "npx",
"args": ["-y", "mcp-agent-trace-inspector@latest"]
}
}
}要设置自定义存储路径，请执行以下操作：
{
"mcpServers": {
"trace-inspector": {
"command": "npx",
"args": [
"-y",
"mcp-agent-trace-inspector@latest",
"--db=~/traces/my-project.db"
]
}
}
}MCP客户端配置
放大器·克劳德码·克莱恩·光标·VS码·风帆·泽德
您的第一个提示
在MCP客户端中输入以下内容以验证一切正常：
Start a trace called "test-run", then list the files in the current directory, then end the trace and show me the summary.您的客户端应返回一个摘要，显示步数、总令牌和延迟。
工具
跟踪生命周期（3个工具）
trace_start--开始新的追踪；返回atrace_id用于后续通话trace_step--记录一个工具调用步骤（输入、输出、可选令牌计数和延迟）trace_end--将跟踪标记为已完成
检查（4个工具）
list_traces--列出存储的跟踪，包括名称、状态和时间戳get_trace_summary--跟踪的令牌总数、步数、延迟和成本估算compare_traces--并排区分两条跟踪（步数、令牌、延迟）extract_reasoning_chain--从痕迹中仅提取推理/思维步骤
导出（3个工具）
export_dashboard--生成具有延迟瀑布图的自包含的单文件HTML仪表板export_otel--以OpenTetry OTLP JSON span格式导出一个或所有跟踪export_compliance_log--将合规性审核日志导出为JSON或CSV，并可选择日期范围过滤
操作（3个工具）
configure_alerts--配置关于延迟、错误率或成本的警报规则；向Slack或通用webhooks开火set_retention_policy--设置保留跟踪的天数（在内存中；必须在之前调用apply_retention)apply_retention--存档跟踪比配置的阈值旧；删除超过阈值2倍的痕迹
配置
--db / --db-path
用于存储跟踪的SQLite数据库文件的路径。
类型： string 违约： ~/.mcp/traces.db
--retention-days
自动删除超过N天的痕迹。设置为 0 禁用。
类型： number 违约： 0
--pricing-table
包含自定义模型定价（$/1K代币）的JSON文件的路径。覆盖内置表。
类型： string
--no-token-count
禁用基于tiktoken的令牌计数。跟踪将省略令牌使用指标。
类型： boolean 违约： false
通过传递旗帜 args JSON配置中的属性：
{
"mcpServers": {
"trace-inspector": {
"command": "npx",
"args": ["-y", "mcp-agent-trace-inspector@latest", "--retention-days=30"]
}
}
}设计原则
- 仅添加痕迹：步骤一旦记录下来就不可变。信任需要正直。
- 本地优先：所有核心功能都可以在没有网络连接的情况下工作。
- 便携式仪表板：HTML导出始终是单个文件；不需要服务器来查看它们。
验证
在发布新版本之前，使用MCP Inspector验证服务器，以确认所有工具都已正确公开，协议握手成功。
交互式用户界面 （打开浏览器）：
npm run build && npm run inspectCLI模式 （脚本/CI友好）：
# List all tools
npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list
# List resources and prompts
npx @modelcontextprotocol/inspector --cli node dist/index.js --method resources/list
npx @modelcontextprotocol/inspector --cli node dist/index.js --method prompts/list
# Call a tool (example — replace with a relevant read-only tool for this plugin)
npx @modelcontextprotocol/inspector --cli node dist/index.js \
--method tools/call --tool-name list_traces
# Call a tool with arguments
npx @modelcontextprotocol/inspector --cli node dist/index.js \
--method tools/call --tool-name list_traces --tool-arg key=value在发布之前运行，以捕获工具注册和运行时启动中的回归。
贡献
看 贡献.md 获取完整的贡献指南。
npm install && npm testMCP注册与市场
此插件可在以下网站上使用：
搜索 mcp-agent-trace-inspector.