MCP Agent Trace Inspector

MCP数据服务

提供方 dbsectrainer · 包名 @modelcontextprotocol/inspector

数据服务 stdio · 本地进程 Token 社区 / 第三方
查看接入方式

MCP代理工作流的本地优先可观测性工具,提供工具调用追踪、持久化存储、HTML仪表盘等功能,适用于敏感数据处理和本地开发环境。

一句话选型结论

按资料字段整理

MCP Agent Trace Inspector 属于数据服务类 MCP 服务器,stdio · 本地进程,Token,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类数据服务 传输方式stdio · 本地进程 鉴权Token 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 13 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

数据服务
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量13暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

工作流追踪TypeScript本地部署本地存储可观测性MCP代理SQLite数据库

安装与配置

stdio · 本地进程 Token
客户端在本机拉起子进程,数据不出本机
npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Node.js,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 13 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
数据库查询

用自然语言查库、取数,不用手写 SQL。

数据同步与清洗

把多来源数据拉到一处做整理。

报表取数

按口径快速拉出统计结果。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 13 个工具,覆盖面较广,能满足多种调用。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在数据服务场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
MCP Agent Trace Inspector当前 13 stdio · 本地进程 本地部署 有 2026-05-17
Memory 9d25f64e 9 未标注 未标注 无 2026-05-17
Getzep MCP 9 stdio · 本地进程 本地部署 有 2026-05-17
anything-llm 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Prisma MCP Server 未标注 stdio · 本地进程 本地部署 有 2026-05-17
Astr Bot 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

数据服务
字段来自项目仓库与公开索引,中文说明由本站标注
提供方dbsectrainer上游标注的维护方 dbsectrainer
分类数据服务本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时@modelcontextprotocol/inspector · Node.js本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

6.4 KB
来自项目仓库与上游目录的原文,未做删改

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客户端:```json
{
"mcpServers": {
"trace-inspector": {
"command": "npx",
"args": ["-y", "mcp-agent-trace-inspector@latest"]
}
}
}


要设置自定义存储路径,请执行以下操作:```json
{
&quot;mcpServers&quot;: {
&quot;trace-inspector&quot;: {
&quot;command&quot;: &quot;npx&quot;,
&quot;args&quot;: [
&quot;-y&quot;,
&quot;mcp-agent-trace-inspector@latest&quot;,
&quot;--db=~/traces/my-project.db&quot;
]
}
}
}

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` --开始新的追踪;返回a `trace_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配置中的属性:```json
{
&quot;mcpServers&quot;: {
&quot;trace-inspector&quot;: {
&quot;command&quot;: &quot;npx&quot;,
&quot;args&quot;: [&quot;-y&quot;, &quot;mcp-agent-trace-inspector@latest&quot;, &quot;--retention-days=30&quot;]
}
}
}

设计原则

  • 仅添加痕迹:步骤一旦记录下来就不可变。信任需要正直。
  • 本地优先:所有核心功能都可以在没有网络连接的情况下工作。
  • 便携式仪表板:HTML导出始终是单个文件;不需要服务器来查看它们。

验证

在发布新版本之前,使用MCP Inspector验证服务器,以确认所有工具都已正确公开,协议握手成功。

交互式用户界面 (打开浏览器):```bash
npm run build && npm run inspect


**CLI模式** (脚本/CI友好):```bash
# 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 获取完整的贡献指南。bash npm install &amp;&amp; npm test

MCP注册与市场

此插件可在以下网站上使用:

  • MCP注册表
  • MCP市场

搜索 mcp-agent-trace-inspector.

常见问题

7 问
答案由本站依据条目字段整理,不引用上游原文
MCP Agent Trace Inspector 怎么安装?

在客户端按下面的安装命令接入:npx @modelcontextprotocol/inspector --cli node dist/index.js --method tools/list。对应的包名是 @modelcontextprotocol/inspector。装完在客户端配置里引用同一个包或端点。

MCP Agent Trace Inspector 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

MCP Agent Trace Inspector 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

MCP Agent Trace Inspector 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

MCP Agent Trace Inspector 能提供哪些能力?

资料显示约 13 个工具;能力标签包括 本地存储、TypeScript、可观测性。具体工具清单以官方文档为准。

MCP Agent Trace Inspector 需要什么运行环境?

运行时为 Node.js;属于本地进程,需要在本机装好运行环境。

MCP Agent Trace Inspector 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。