# @agent-inspect/mcp-server 中文文档

规范地址：https://npmcn.com/package/%40agent-inspect/mcp-server/

版本：6\.31\.35
npm 元数据更新时间：2026-11-04T20:00:41.036Z
中文译文更新时间：2026-11-06T09:09:10.039Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40agent-inspect/mcp-server
原文对照：https://npmcn.com/package/%40agent-inspect/mcp-server/?lang=original
项目主页：https://github.com/rajudandigam/agent-inspect/tree/main/packages/mcp-server
源码仓库：https://github.com/rajudandigam/agent-inspect

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：4.2 MB，16 个文件
- 模块格式：ESM + CJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-06-29T04:14:54.178Z
- 最新版本发布：2026-11-04T20:00:40.707Z
- 近 30 天下载量：3650（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：117（近 12 个月 117 个）

## 中文简介

仅为本地代理的 MCP 服务器

## 安装

```sh
npm install @agent-inspect/mcp-server
```

也可以使用：`pnpm add @agent-inspect/mcp-server`、`yarn add @agent-inspect/mcp-server`、`bun add @agent-inspect/mcp-server`

## README

# @ agent-inspect/mcp-服务器

只读 MCP 服务器 **本地编码代理调试循环**: 列表运行、总结失败、检查树木、评价合同和获取 **追踪事实** (单位:千美元)`get_trace_facts`)——不使用代理工具或变异痕迹.

**支助级别:** 预览-见 [支助](https://github.com/rajudandigam/agent-inspect/blob/main/docs/SUPPORT-LEVELS.md)。 。 。 .

[![agent-inspect MCP server](https://glama.ai/mcp/servers/rajudandigam/agent-inspect/badges/score.svg)](https://glama.ai/mcp/servers/rajudandigam/agent-inspect)

## 何时使用

-   让 Cursor, Claude 代码, Codex, 双子座, 或其他 MCP 客户端检查本地 `.agent-inspect/` 证据
-   用 CLI 检查所用的相同 TraceFacts 调试失败的轨迹

## 不使用时

-   通过 MCP 引用目标应用工具
-   上传到远程 MCP 主机/ 收藏器
-   期待服务器编辑应用程序代码

## 安装

```bash
npm install @agent-inspect/mcp-server
# optional helper:
npx agent-inspect mcp configure --client cursor
```

## 示例

```bash
npx @agent-inspect/mcp-server --dir .agent-inspect
```

## 旗舰工具( 只读)

| 工具 | 作用 |
| --- | --- |
| `list_recent_runs` 编号 : `list_recent_failures` | 浏览本地运行 |
| `get_run_summary` 编号 : `get_execution_tree` | 边界摘要 |
| `get_first_causal_failure` | 确定第一个因果失败 |
| `get_contract_failures` | 跟踪合同/ 检查失败 |
| `get_trace_facts` | 跟踪事实/语义等同摘要 |
| `compare_runs` | 结构 diff |
| `create_share_checked_evidence` | 共享证据包 |

### 第一次因果失败模糊

无关联的失败仍然无关紧要. `get_first_causal_failure` 不推断 事件附带性或时间上的因果关系 如此模糊的关系 仍然明确,而不是捏造.

结果经过了编辑(默认的共享配置),设定了界限,并确定了相同投入.

每个 `tools/list` 条目包括 MCP **提示** 说明`readOnlyHint`, (中文(简体) ), `destructiveHint`, (中文(简体) ), `idempotentHint`, (中文(简体) ), `openWorldHint`) (中文(简体) ). 说明不是授权或证明——见 [MCP.md (英语)](https://github.com/rajudandigam/agent-inspect/blob/main/docs/MCP.md)。 。 。 .

## 隐私

-   仅读取本地跟踪目录
-   工具结果会通过共享的编辑/大小边界
-   将本地证据配置到 **已连接的 MCP 客户端** ——将客户端视为信任边界
-   没有痕量突变; 没有代理工具引用; 没有默认上传

## 限制

-   预览表面——工具目录和边框可能会演进
-   不是网关或远程上传服务
-   无法取代托管的 APM

## 文档

-   [副警长办公室d](https://github.com/rajudandigam/agent-inspect/blob/main/docs/CODING-AGENT-LOOP.md)
-   [TRACE-FACTS.md (美国)](https://github.com/rajudandigam/agent-inspect/blob/main/docs/TRACE-FACTS.md)
-   [无埃及-警察](https://github.com/rajudandigam/agent-inspect/blob/main/docs/NO-EGRESS-POLICY.md)

## 解决问题

-   **空资源 :** 确认 `--dir` jSONL 跟踪点
-   **警卫:** 不经过编辑审查, 不要在本地主机之外曝光服务器

## 版本

部分固定代理监取放行. 参见当前版本的npm徽章/包表.

## 许可证

麻省理工学院

## 常见问题

### @agent-inspect/mcp-server 是什么？

仅为本地代理的 MCP 服务器

### 如何安装 @agent-inspect/mcp-server？

在项目目录运行 npm install @agent-inspect/mcp-server，或使用 pnpm add / yarn add / bun add。它还提供命令行工具 agent-inspect-mcp-server，可以用 npx agent-inspect-mcp-server 直接运行。

### @agent-inspect/mcp-server 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @agent-inspect/mcp-server 支持 ESM 还是 CommonJS？

同时提供 ES Module 与 CommonJS 入口，import 和 require\(\) 都可以使用，打包工具会自动选择合适的版本。

### @agent-inspect/mcp-server 可以商用吗？

@agent-inspect/mcp-server 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @agent-inspect/mcp-server 的下载量有多少？

根据 npm 官方下载统计，@agent-inspect/mcp-server 在 2026/10/05 – 2026/11/03 这 30 天内被下载 3,650 次，日均约 122 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @agent-inspect/mcp-server 还在维护吗？

最新版本 6\.31\.35 发布于 2026/11/05（1 天前）；至今共发布 117 个版本，其中过去 12 个月发布了 117 个；首次发布于 2026/06/29。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。