@agent-inspect/mcp-server 6.14.0 → 6.14.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +27 -18
- package/package.json +12 -4
package/README.md
CHANGED
|
@@ -1,64 +1,73 @@
|
|
|
1
1
|
# @agent-inspect/mcp-server
|
|
2
2
|
|
|
3
|
-
Read-only MCP server
|
|
3
|
+
Read-only MCP server for the **local coding-agent debug loop**: list runs, summarize failures, inspect trees, evaluate contracts, and fetch **TraceFacts** (`get_trace_facts`) — without invoking agent tools or mutating traces.
|
|
4
4
|
|
|
5
5
|
|
|
6
6
|
**Support level:** Preview — see [SUPPORT-LEVELS.md](https://github.com/rajudandigam/agent-inspect/blob/main/docs/SUPPORT-LEVELS.md).
|
|
7
7
|
|
|
8
8
|
## When to use
|
|
9
9
|
|
|
10
|
-
- Let MCP
|
|
11
|
-
-
|
|
10
|
+
- Let Cursor, Claude Code, Codex, Gemini, or other MCP clients inspect local `.agent-inspect/` evidence
|
|
11
|
+
- Debug failed trajectories with the same TraceFacts used by CLI checks
|
|
12
12
|
|
|
13
13
|
## When not to use
|
|
14
14
|
|
|
15
|
-
- Invoking
|
|
16
|
-
- Uploading traces to a remote MCP host
|
|
15
|
+
- Invoking target-app tools through MCP
|
|
16
|
+
- Uploading traces to a remote MCP host / collector
|
|
17
|
+
- Expecting the server to edit application code
|
|
17
18
|
|
|
18
19
|
## Install
|
|
19
20
|
|
|
20
21
|
```bash
|
|
21
22
|
npm install @agent-inspect/mcp-server
|
|
23
|
+
# optional helper:
|
|
24
|
+
npx agent-inspect mcp configure --client cursor
|
|
22
25
|
```
|
|
23
26
|
|
|
24
27
|
## Example
|
|
25
28
|
|
|
26
29
|
```bash
|
|
27
30
|
npx @agent-inspect/mcp-server --dir .agent-inspect
|
|
28
|
-
# or after install:
|
|
29
|
-
# npx agent-inspect-mcp-server --dir .agent-inspect
|
|
30
31
|
```
|
|
31
32
|
|
|
33
|
+
## Flagship tools (read-only)
|
|
34
|
+
|
|
35
|
+
| Tool | Role |
|
|
36
|
+
|------|------|
|
|
37
|
+
| `list_recent_runs` / `list_recent_failures` | Browse local runs |
|
|
38
|
+
| `get_run_summary` / `get_execution_tree` | Bounded summaries |
|
|
39
|
+
| `get_first_causal_failure` | Deterministic first causal failure |
|
|
40
|
+
| `get_contract_failures` | TraceContract / check failures |
|
|
41
|
+
| `get_trace_facts` | TraceFacts / semantic parity summary |
|
|
42
|
+
| `compare_runs` | Structural diff |
|
|
43
|
+
| `create_share_checked_evidence` | Share-gated Evidence package |
|
|
44
|
+
|
|
45
|
+
Results are redacted (share profile by default), bounded, and deterministic for the same inputs.
|
|
46
|
+
|
|
32
47
|
## Privacy
|
|
33
48
|
|
|
34
49
|
- Reads local trace directory only
|
|
35
50
|
- Tool results go through a share-profile redaction / size boundary
|
|
36
51
|
- Exposes configured local evidence to the **connected MCP client** — treat that client as a trust boundary
|
|
37
|
-
- No trace mutation; no agent tool invocation
|
|
52
|
+
- No trace mutation; no agent tool invocation; no default upload
|
|
38
53
|
|
|
39
54
|
## Limitations
|
|
40
55
|
|
|
41
56
|
- Preview surface — tool catalog and bounds may evolve
|
|
42
57
|
- Not a gateway or remote upload service
|
|
43
|
-
|
|
44
|
-
## API
|
|
45
|
-
|
|
46
|
-
CLI entry: read-only resources for trace listing/search.
|
|
47
|
-
|
|
48
|
-
## CLI
|
|
49
|
-
|
|
50
|
-
Prefer `agent-inspect list` / `view` for humans; MCP server for tool integrations.
|
|
58
|
+
- Not a substitute for hosted APM
|
|
51
59
|
|
|
52
60
|
## Docs
|
|
53
61
|
|
|
54
|
-
- [
|
|
62
|
+
- [CODING-AGENT-LOOP.md](https://github.com/rajudandigam/agent-inspect/blob/main/docs/CODING-AGENT-LOOP.md)
|
|
63
|
+
- [TRACE-FACTS.md](https://github.com/rajudandigam/agent-inspect/blob/main/docs/TRACE-FACTS.md)
|
|
64
|
+
- [NO-EGRESS-POLICY.md](https://github.com/rajudandigam/agent-inspect/blob/main/docs/NO-EGRESS-POLICY.md)
|
|
55
65
|
|
|
56
66
|
## Troubleshooting
|
|
57
67
|
|
|
58
68
|
- **Empty resources:** Confirm `--dir` points at JSONL traces
|
|
59
69
|
- **Security:** Do not expose server beyond localhost without redaction review
|
|
60
70
|
|
|
61
|
-
|
|
62
71
|
## Version
|
|
63
72
|
|
|
64
73
|
Part of the fixed AgentInspect release line. See the npm badge / package manifest for the current version.
|
package/package.json
CHANGED
|
@@ -1,9 +1,9 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@agent-inspect/mcp-server",
|
|
3
|
-
"version": "6.14.
|
|
3
|
+
"version": "6.14.1",
|
|
4
4
|
"license": "MIT",
|
|
5
5
|
"type": "module",
|
|
6
|
-
"description": "Read-only MCP server
|
|
6
|
+
"description": "Read-only MCP server for local AgentInspect TraceFacts, causal failure, and Evidence tools",
|
|
7
7
|
"repository": {
|
|
8
8
|
"type": "git",
|
|
9
9
|
"url": "git+https://github.com/rajudandigam/agent-inspect.git",
|
|
@@ -38,13 +38,21 @@
|
|
|
38
38
|
"dist"
|
|
39
39
|
],
|
|
40
40
|
"dependencies": {
|
|
41
|
-
"@agent-inspect/redact": "6.14.
|
|
42
|
-
"agent-inspect": "6.14.
|
|
41
|
+
"@agent-inspect/redact": "6.14.1",
|
|
42
|
+
"agent-inspect": "6.14.1"
|
|
43
43
|
},
|
|
44
44
|
"peerDependencies": {},
|
|
45
45
|
"publishConfig": {
|
|
46
46
|
"access": "public"
|
|
47
47
|
},
|
|
48
|
+
"keywords": [
|
|
49
|
+
"mcp",
|
|
50
|
+
"agent-inspect",
|
|
51
|
+
"tracefacts",
|
|
52
|
+
"coding-agent",
|
|
53
|
+
"local-first",
|
|
54
|
+
"typescript"
|
|
55
|
+
],
|
|
48
56
|
"scripts": {
|
|
49
57
|
"build": "pnpm --workspace-root exec tsup --config tsup.mcp-server.config.ts",
|
|
50
58
|
"test": "vitest run -c ../../vitest.config.ts"
|