ctxjev-mcp 0.1.1 → 0.1.3
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 +12 -10
- package/package.json +22 -2
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# ctxjev-mcp
|
|
4
4
|
|
|
5
|
-
**Jev-based context scoring, as MCP tools
|
|
5
|
+
**Jev-based context scoring, as MCP tools for Claude Code, Codex, and any other MCP host.**
|
|
6
6
|
|
|
7
7
|
[](https://www.npmjs.com/package/ctxjev-mcp)
|
|
8
8
|
[](LICENSE)
|
|
@@ -14,7 +14,7 @@
|
|
|
14
14
|
|
|
15
15
|
---
|
|
16
16
|
|
|
17
|
-
`ctxjev-mcp` speaks plain stdio MCP
|
|
17
|
+
`ctxjev-mcp` speaks plain stdio MCP: the same binary works with every host below, and only the
|
|
18
18
|
config shape differs.
|
|
19
19
|
|
|
20
20
|
## Setup
|
|
@@ -34,7 +34,7 @@ claude mcp add ctxjev --env TYPESAFE_API_KEY=... -- npx ctxjev-mcp
|
|
|
34
34
|
codex mcp add ctxjev --env TYPESAFE_API_KEY=... -- npx ctxjev-mcp
|
|
35
35
|
```
|
|
36
36
|
|
|
37
|
-
**GitHub Copilot** (VS Code, agent mode)
|
|
37
|
+
**GitHub Copilot** (VS Code, agent mode) uses `.vscode/mcp.json` (note the top-level key is
|
|
38
38
|
`servers`, not Claude Code's `mcpServers`):
|
|
39
39
|
|
|
40
40
|
```json
|
|
@@ -52,16 +52,16 @@ codex mcp add ctxjev --env TYPESAFE_API_KEY=... -- npx ctxjev-mcp
|
|
|
52
52
|
|
|
53
53
|
## Tools
|
|
54
54
|
|
|
55
|
-
- **`score_relevance`**
|
|
56
|
-
per entry plus Jev token usage, no decision made.
|
|
57
|
-
- **`prune_history`**
|
|
58
|
-
(`keep`/`drop`/`summarize`) per entry, a savings report, and Jev token usage.
|
|
55
|
+
- **`score_relevance`** takes `{ goal, entries, recencyWeight? }` and returns a
|
|
56
|
+
relevance/recency/combined score per entry plus Jev token usage, with no decision made.
|
|
57
|
+
- **`prune_history`** takes the same input plus `{ dropBelow?, summarizeBelow? }` and returns a
|
|
58
|
+
decision (`keep`/`drop`/`summarize`) per entry, a savings report, and Jev token usage.
|
|
59
59
|
|
|
60
60
|
`entries` is `{ id, role: 'user'|'assistant'|'tool', toolName?, content, timestamp }[]`.
|
|
61
61
|
|
|
62
62
|
## Example response
|
|
63
63
|
|
|
64
|
-
Calling `prune_history` with two entries
|
|
64
|
+
Calling `prune_history` with two entries, one obviously relevant to the goal and one not, returns:
|
|
65
65
|
|
|
66
66
|
```json
|
|
67
67
|
{
|
|
@@ -77,7 +77,7 @@ Calling `prune_history` with two entries — one obviously relevant to the goal,
|
|
|
77
77
|
}
|
|
78
78
|
```
|
|
79
79
|
|
|
80
|
-
|
|
80
|
+
This is a real response body, captured against the live API.
|
|
81
81
|
|
|
82
82
|
## Related packages
|
|
83
83
|
|
|
@@ -91,4 +91,6 @@ Full docs, design notes, and per-host setup live in the main repo:
|
|
|
91
91
|
|
|
92
92
|
## License
|
|
93
93
|
|
|
94
|
-
[MIT](LICENSE)
|
|
94
|
+
[MIT](LICENSE): free to use, modify, and distribute, including in a commercial product, as long
|
|
95
|
+
as the license text and copyright notice ship with it. See the [main repo](https://github.com/x96x64/ctxjev#license)
|
|
96
|
+
for how this matches every dependency `ctxjev` currently uses.
|
package/package.json
CHANGED
|
@@ -1,14 +1,34 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "ctxjev-mcp",
|
|
3
|
-
"version": "0.1.
|
|
3
|
+
"version": "0.1.3",
|
|
4
4
|
"description": "MCP server exposing ctxjev's Jev-based context scoring/pruning as tools for any MCP-capable agent host.",
|
|
5
|
+
"keywords": [
|
|
6
|
+
"mcp",
|
|
7
|
+
"model-context-protocol",
|
|
8
|
+
"ai-agent",
|
|
9
|
+
"llm",
|
|
10
|
+
"context-pruning",
|
|
11
|
+
"jev",
|
|
12
|
+
"claude-code",
|
|
13
|
+
"codex"
|
|
14
|
+
],
|
|
5
15
|
"license": "MIT",
|
|
16
|
+
"author": {
|
|
17
|
+
"name": "x96x64",
|
|
18
|
+
"url": "https://github.com/x96x64"
|
|
19
|
+
},
|
|
6
20
|
"repository": {
|
|
7
21
|
"type": "git",
|
|
8
22
|
"url": "git+https://github.com/x96x64/ctxjev.git",
|
|
9
23
|
"directory": "packages/mcp-server"
|
|
10
24
|
},
|
|
11
25
|
"homepage": "https://github.com/x96x64/ctxjev/tree/main/packages/mcp-server#readme",
|
|
26
|
+
"bugs": {
|
|
27
|
+
"url": "https://github.com/x96x64/ctxjev/issues"
|
|
28
|
+
},
|
|
29
|
+
"engines": {
|
|
30
|
+
"node": ">=20"
|
|
31
|
+
},
|
|
12
32
|
"type": "module",
|
|
13
33
|
"main": "./dist/index.js",
|
|
14
34
|
"files": [
|
|
@@ -20,7 +40,7 @@
|
|
|
20
40
|
"dependencies": {
|
|
21
41
|
"@modelcontextprotocol/sdk": "^1.30.0",
|
|
22
42
|
"zod": "^4.6.5",
|
|
23
|
-
"ctxjev-core": "0.1.
|
|
43
|
+
"ctxjev-core": "0.1.3"
|
|
24
44
|
},
|
|
25
45
|
"devDependencies": {
|
|
26
46
|
"@types/node": "^22",
|