driftguard-mcp 0.1.0 → 0.1.2
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 +57 -8
- package/package.json +12 -4
- package/dist/mcp-server.js +0 -1864
package/README.md
CHANGED
|
@@ -1,8 +1,8 @@
|
|
|
1
|
-
#
|
|
1
|
+
# driftguard-mcp
|
|
2
2
|
|
|
3
|
-
Real-time AI conversation drift monitor for Claude Code.
|
|
3
|
+
Real-time AI conversation drift monitor — MCP server for Claude Code, Gemini CLI, Codex CLI, and Cursor.
|
|
4
4
|
|
|
5
|
-
Reads your
|
|
5
|
+
Reads your session directly, scores it across 7 factors, and exposes the result as MCP tools you can call mid-session. No browser, no API keys, no UI — just a score when you need it.
|
|
6
6
|
|
|
7
7
|
---
|
|
8
8
|
|
|
@@ -12,12 +12,16 @@ Reads your Claude Code session directly, scores it across 7 factors, and exposes
|
|
|
12
12
|
npm install -g driftguard-mcp
|
|
13
13
|
```
|
|
14
14
|
|
|
15
|
-
Then add
|
|
15
|
+
Then add it to your AI CLI config.
|
|
16
|
+
|
|
17
|
+
### Claude Code
|
|
18
|
+
|
|
19
|
+
Add to `~/.claude.json`:
|
|
16
20
|
|
|
17
21
|
```json
|
|
18
22
|
{
|
|
19
23
|
"mcpServers": {
|
|
20
|
-
"
|
|
24
|
+
"driftguard": {
|
|
21
25
|
"command": "driftguard-mcp"
|
|
22
26
|
}
|
|
23
27
|
}
|
|
@@ -26,11 +30,55 @@ Then add DriftCLI to your Claude Code MCP config at `~/.claude.json`:
|
|
|
26
30
|
|
|
27
31
|
Restart Claude Code. The `get_drift`, `get_handoff`, and `get_trend` tools are now available in every session.
|
|
28
32
|
|
|
33
|
+
### Gemini CLI
|
|
34
|
+
|
|
35
|
+
Add to `~/.gemini/settings.json`:
|
|
36
|
+
|
|
37
|
+
```json
|
|
38
|
+
{
|
|
39
|
+
"mcpServers": {
|
|
40
|
+
"driftguard": {
|
|
41
|
+
"command": "driftguard-mcp"
|
|
42
|
+
}
|
|
43
|
+
}
|
|
44
|
+
}
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
### Codex CLI
|
|
48
|
+
|
|
49
|
+
Add to `~/.codex/config.json`:
|
|
50
|
+
|
|
51
|
+
```json
|
|
52
|
+
{
|
|
53
|
+
"mcpServers": {
|
|
54
|
+
"driftguard": {
|
|
55
|
+
"command": "driftguard-mcp"
|
|
56
|
+
}
|
|
57
|
+
}
|
|
58
|
+
}
|
|
59
|
+
```
|
|
60
|
+
|
|
61
|
+
### Cursor
|
|
62
|
+
|
|
63
|
+
Add to `~/.cursor/mcp.json`:
|
|
64
|
+
|
|
65
|
+
```json
|
|
66
|
+
{
|
|
67
|
+
"mcpServers": {
|
|
68
|
+
"driftguard": {
|
|
69
|
+
"command": "driftguard-mcp"
|
|
70
|
+
}
|
|
71
|
+
}
|
|
72
|
+
}
|
|
73
|
+
```
|
|
74
|
+
|
|
75
|
+
> Note: Cursor drift is calculated from any active Claude Code, Gemini CLI, or Codex CLI sessions on your machine — not from Cursor's own conversation history.
|
|
76
|
+
|
|
29
77
|
---
|
|
30
78
|
|
|
31
79
|
## Usage
|
|
32
80
|
|
|
33
|
-
Call the tools directly from any
|
|
81
|
+
Call the tools directly from any session:
|
|
34
82
|
|
|
35
83
|
- **`get_drift()`** — check the current drift score
|
|
36
84
|
- **`get_handoff()`** — generate a handoff prompt when drift is high
|
|
@@ -40,7 +88,7 @@ Call the tools directly from any Claude Code session:
|
|
|
40
88
|
|
|
41
89
|
## What is drift?
|
|
42
90
|
|
|
43
|
-
Long AI sessions degrade. The model starts repeating itself, losing track of the original goal, hedging more, and producing inconsistent code.
|
|
91
|
+
Long AI sessions degrade. The model starts repeating itself, losing track of the original goal, hedging more, and producing inconsistent code. driftguard-mcp measures this in real time across 7 factors:
|
|
44
92
|
|
|
45
93
|
| Factor | What it measures |
|
|
46
94
|
|--------|-----------------|
|
|
@@ -91,7 +139,7 @@ Shows the full drift history for the current session — sparkline, score sequen
|
|
|
91
139
|
|
|
92
140
|
## Configuration
|
|
93
141
|
|
|
94
|
-
|
|
142
|
+
driftguard-mcp looks for config in two places, merged together:
|
|
95
143
|
|
|
96
144
|
- **Global:** `~/.driftclirc`
|
|
97
145
|
- **Per-project:** `.driftcli` in the project root
|
|
@@ -144,3 +192,4 @@ driftguard-mcp watch
|
|
|
144
192
|
| Claude Code | Supported |
|
|
145
193
|
| Gemini CLI | Supported |
|
|
146
194
|
| Codex CLI | Supported |
|
|
195
|
+
| Cursor | Supported (monitors Claude Code / Gemini / Codex sessions) |
|
package/package.json
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "driftguard-mcp",
|
|
3
|
-
"version": "0.1.
|
|
4
|
-
"description": "Real-time AI conversation drift monitor for Claude Code
|
|
3
|
+
"version": "0.1.2",
|
|
4
|
+
"description": "Real-time AI conversation drift monitor — MCP server for Claude Code, Gemini CLI, Codex CLI, and Cursor",
|
|
5
5
|
"main": "dist/bin.js",
|
|
6
6
|
"bin": {
|
|
7
7
|
"driftguard-mcp": "dist/bin.js"
|
|
@@ -26,11 +26,19 @@
|
|
|
26
26
|
"drift",
|
|
27
27
|
"ai",
|
|
28
28
|
"context",
|
|
29
|
-
"claude-code"
|
|
29
|
+
"claude-code",
|
|
30
|
+
"cursor",
|
|
31
|
+
"gemini",
|
|
32
|
+
"codex"
|
|
30
33
|
],
|
|
31
|
-
"author": "",
|
|
34
|
+
"author": "jschoemaker",
|
|
32
35
|
"license": "ISC",
|
|
33
36
|
"type": "commonjs",
|
|
37
|
+
"repository": {
|
|
38
|
+
"type": "git",
|
|
39
|
+
"url": "https://github.com/jschoemaker/driftguard-mcp"
|
|
40
|
+
},
|
|
41
|
+
"homepage": "https://github.com/jschoemaker/driftguard-mcp#readme",
|
|
34
42
|
"dependencies": {
|
|
35
43
|
"@modelcontextprotocol/sdk": "^1.27.1",
|
|
36
44
|
"chokidar": "^5.0.0",
|