mcpField
A
agentsnap

agentsnap

本地服务
github.com开发工具020 周前更新
代码仓库访问官网

关于 agentsnap

agentsnap-mcp 是用于检查和测试 AI Agent 工具调用轨迹的 MCP 服务。开发者可规范化轨迹、比较运行结果并验证已保存的快照，以发现变化和回归问题。

主要功能

  1. 01规范化轨迹并生成指纹
  2. 02比较基线与当前轨迹
  3. 03分类轨迹变化和回归
  4. 04按轨迹架构验证快照
  5. 05比较时忽略指定路径

适用场景

  1. 01检查不同版本间的 Agent 轨迹
  2. 02识别工具调用或输出变化
  3. 03验证已保存的轨迹快照
  4. 04在回归检查中排除易变字段

MCP 相关

该 MCP 服务向 Claude Desktop、Cursor、Cline、Windsurf 和 Zed 等 MCP 客户端提供轨迹规范化、比较和验证工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "mukundakatta-agentsnap": {
      "command": "npx",
      "args": [
        "-y",
        "@mukundakatta/agentsnap-mcp"
      ]
    }
  }
}
启动命令npx -y @mukundakatta/agentsnap-mcp

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@mukundakatta/agentsnap-mcp0.1.0

工具

3

收录的工具列表 · 更新于 3 周前

参数类型必填说明
inputstring否可选的输入字符串，将嵌入 trace.input 中。
modelstring否可选的模型标识符，将嵌入 trace.model 中。
traceany是工具调用条目数组（每项为 {name, args, result?, error?}），或带有 tools[] 字段的部分 Trace 对象。
outputstring否要嵌入 trace.output 的可选输出字符串。

详细介绍

agentsnap-mcp

npm tests mcp

一个 MCP 服务，可让 AI 助手检查、规范化、对比和验证 Agent 工具调用轨迹。

基于 @mukundakatta/agentsnap 构建。适用于 Claude Desktop、Cursor、Cline、Windsurf、Zed，以及任何其他 MCP 客户端。

提供的工具

normalize_trace

将原始工具调用轨迹转换为规范的 agentsnap Trace 格式，并计算确定性的 SHA-256 指纹哈希。可用于快速比较运行结果，或将结果传给下游对比工具。

{
  "trace": [
    { "name": "search", "args": { "q": "cats" } },
    { "name": "fetch",  "args": "https://example.com" }
  ],
  "input": "find cats",
  "model": "claude-opus-4-7"
}

→

{
  "normalized": {
    "version": 1,
    "model": "claude-opus-4-7",
    "input": "find cats",
    "output": null,
    "tools": [
      { "name": "search", "args": { "q": "cats" } },
      { "name": "fetch",  "args": "https://example.com" }
    ],
    "error": null,
    "fingerprint": { "node": "v22.0.0", "agentsnap": "0.1.0" }
  },
  "hash": "sha256:..."
}
diff_traces

将基准轨迹与当前运行结果进行对比。返回统一的新增项／移除项／变更描述，以及 agentsnap 状态码（PASSED、OUTPUT_DRIFT、TOOLS_REORDERED、TOOLS_CHANGED、REGRESSION）。使用 ignore_paths 可在分类前忽略容易产生噪声的字段。

{
  "baseline": { "version": 1, "tools": [{ "name": "search", "args": { "q": "cats" }, "result_hash": "sha256:aaa" }], "error": null, "fingerprint": {...} },
  "current":  { "version": 1, "tools": [{ "name": "search", "args": { "q": "cats" }, "result_hash": "sha256:bbb" }], "error": null, "fingerprint": {...} },
  "ignore_paths": ["tools[].result_hash"]
}

→ { "same": true, "status": "PASSED", "additions": [], "removals": [], "changes": [] }

validate_snapshot

检查快照是否符合 agentsnap Trace 架构。验证必填字段和工具条目格式，并指出可采取措施解决的问题。成功时返回 valid=true，否则返回一系列易读的问题描述。

安装

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "agentsnap": {
      "command": "npx",
      "args": ["-y", "@mukundakatta/agentsnap-mcp"]
    }
  }
}
Cursor / Cline / Windsurf / Zed

在客户端对应的 mcp.json 中使用相同格式。大多数客户端会通过 npx -y @mukundakatta/agentsnap-mcp 自动发现。

本地安装
npm install -g @mukundakatta/agentsnap-mcp
mcp-agentsnap        # listens on stdio

这为何重要

Agent 调用工具时可能会悄然发生偏移。工具参数的格式发生变化、非确定性结果改变下游分支，或是在发布版本之间悄悄加入额外工具——这些情况都不会在单元测试中显现。agentsnap 会捕获轨迹；此 MCP 服务则让助手可以直接检查和分析轨迹：规范化一条轨迹、对比两条轨迹，或验证已保存的快照，所有操作都可通过模型的工具调用界面完成。

许可证

MIT。

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。