context-doctor 0.3.6 → 0.4.0
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 -8
- package/dist/hook.js +2 -2
- package/dist/install.js +8 -0
- package/dist/ledger.js +4 -1
- package/dist/mcp.js +126 -62
- package/dist/test/mcp-http.test.d.ts +6 -0
- package/dist/test/mcp-http.test.js +63 -0
- package/package.json +2 -2
package/README.md
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
# context-doctor 🩺
|
|
2
2
|
|
|
3
|
+
[](https://github.com/KushalP1/context-doctor/actions) [](https://www.npmjs.com/package/context-doctor)
|
|
4
|
+
|
|
3
5
|
**See what's eating your LLM context window — and fix it.**
|
|
4
6
|
|
|
5
7
|
Every long-running LLM conversation slowly fills up with junk: duplicated documents, 10k-token tool outputs nobody reads again, base64 blobs, stale history. You pay for those tokens on **every single call**, and model quality drops as the window fills.
|
|
@@ -93,7 +95,8 @@ Practical upshot: a developer who only wants cheaper, faster API calls never tou
|
|
|
93
95
|
| `context-doctor session [file]` | Profile a Claude Code session transcript (defaults to your most recent; `--list` to browse) |
|
|
94
96
|
| `context-doctor report` | Machine-wide impact report: exact proxy savings, hook activity, recoverable waste in recent sessions |
|
|
95
97
|
| `context-doctor proxy` | Always-on local proxy that optimizes every Anthropic/OpenAI API request in flight (`/stats` for cumulative savings) |
|
|
96
|
-
| `context-doctor hook` | The every-prompt Claude Code hook (registered by `install`; you never run this yourself) |
|
|
98
|
+
| `context-doctor hook` | The every-prompt Claude Code hook (registered by `install`; you never run this yourself). Warning threshold tunable via `CONTEXT_DOCTOR_WARN_TOKENS` (default 80000) |
|
|
99
|
+
| `context-doctor-mcp` | The MCP server itself — stdio by default (what the installer wires); `--http [--port 8808] [--host H]` serves streamable HTTP at `/mcp` for URL-based clients like ChatGPT developer-mode connectors |
|
|
97
100
|
|
|
98
101
|
## What "always-on" means, per surface
|
|
99
102
|
|
|
@@ -175,7 +178,7 @@ Because prompt caching matches byte-identical prefixes, deterministic strategies
|
|
|
175
178
|
| Claude Desktop | `npx context-doctor install` writes the config — just restart the app |
|
|
176
179
|
| Claude Code | Same command — MCP + skill + every-prompt hook, all automatic |
|
|
177
180
|
| Cursor | Same command — writes `~/.cursor/mcp.json` |
|
|
178
|
-
| ChatGPT
|
|
181
|
+
| ChatGPT (developer mode) | **Manual + a reachable URL** — ChatGPT connects to servers over the internet, never local commands. Run `context-doctor-mcp --http` on a host/tunnel, then add the URL as a connector. Normal ChatGPT (no dev mode) has no MCP — use the CLI |
|
|
179
182
|
|
|
180
183
|
For any other MCP client, the server entry is:
|
|
181
184
|
|
|
@@ -197,14 +200,15 @@ For any other MCP client, the server entry is:
|
|
|
197
200
|
3. Chat normally. When a conversation grows heavy, Claude proactively offers: *"this chat is getting large — want me to profile it?"* — or you ask *"what's eating my context?"* and it calls `profile_context` and shows the token/cost breakdown.
|
|
198
201
|
4. Say *"optimize it"* and Claude applies the safe fixes; if you agree to pruning old history, **Claude itself writes the replacement summary** (that's the no-API-key summarization).
|
|
199
202
|
|
|
200
|
-
### How it works in ChatGPT, step by step
|
|
203
|
+
### How it works in ChatGPT, step by step (honest version)
|
|
204
|
+
|
|
205
|
+
ChatGPT's MCP support differs fundamentally from Claude Desktop's: **it never spawns local processes**. Its custom connectors (developer mode) have OpenAI's servers connect to a **URL** — so the MCP server must be reachable from the internet.
|
|
201
206
|
|
|
202
|
-
1. ChatGPT
|
|
203
|
-
2.
|
|
204
|
-
3.
|
|
205
|
-
4. Caveat: how prominently standing server instructions surface varies by ChatGPT version — the tool descriptions carry the trigger rules regardless, so profiling still fires on the right questions.
|
|
207
|
+
1. **Normal ChatGPT (no developer mode): no MCP at all.** context-doctor still helps via the CLI: export the conversation and run `npx context-doctor analyze chat.json --model gpt-5` / `optimize` — no account settings required.
|
|
208
|
+
2. **ChatGPT developer mode**: run our HTTP transport somewhere reachable — `context-doctor-mcp --http --port 8808` on a small host (bind `--host 0.0.0.0` there), or expose your machine temporarily with a tunnel (`ngrok http 8808`). Then Settings → Connectors → Advanced → Developer mode → add connector with URL `https://<your-host>/mcp`.
|
|
209
|
+
3. Once connected, GPT gets the same three tools with the same trigger guidance: ask *"what's eating my context?"* → it calls `profile_context`; *"optimize it"* works the same, including GPT writing the pruning summary itself.
|
|
206
210
|
|
|
207
|
-
|
|
211
|
+
Security note for step 2: the HTTP endpoint is unauthenticated — put it behind your tunnel's auth or a reverse proxy if it stays up long-term.
|
|
208
212
|
|
|
209
213
|
### claude.ai on the web
|
|
210
214
|
|
package/dist/hook.js
CHANGED
|
@@ -17,8 +17,8 @@ import { profileConversation } from "./profile.js";
|
|
|
17
17
|
import { parseSessionFile } from "./session.js";
|
|
18
18
|
import { formatTokens } from "./tokens.js";
|
|
19
19
|
import { formatUsd } from "./pricing.js";
|
|
20
|
-
/** Start nudging at 80k tokens of context. */
|
|
21
|
-
const WARN_TOKENS = 80_000;
|
|
20
|
+
/** Start nudging at 80k tokens of context (override: CONTEXT_DOCTOR_WARN_TOKENS). */
|
|
21
|
+
const WARN_TOKENS = Number(process.env.CONTEXT_DOCTOR_WARN_TOKENS) > 0 ? Number(process.env.CONTEXT_DOCTOR_WARN_TOKENS) : 80_000;
|
|
22
22
|
/** Re-nudge only after the context grows another 40% — one reminder, not a nag. */
|
|
23
23
|
const REGROWTH_FACTOR = 1.4;
|
|
24
24
|
/**
|
package/dist/install.js
CHANGED
|
@@ -167,5 +167,13 @@ export function runUninstall() {
|
|
|
167
167
|
console.log("✓ Agent Skill removed");
|
|
168
168
|
}
|
|
169
169
|
uninstallHook();
|
|
170
|
+
// Remove our bookkeeping files too — uninstall means gone.
|
|
171
|
+
for (const file of [".context-doctor-hook-state.json", ".context-doctor-ledger.jsonl"]) {
|
|
172
|
+
const p = join(homedir(), ".claude", file);
|
|
173
|
+
if (existsSync(p)) {
|
|
174
|
+
rmSync(p);
|
|
175
|
+
console.log(`✓ Removed ${file}`);
|
|
176
|
+
}
|
|
177
|
+
}
|
|
170
178
|
console.log("Done.");
|
|
171
179
|
}
|
package/dist/ledger.js
CHANGED
|
@@ -8,7 +8,7 @@
|
|
|
8
8
|
* (pre-0.3.6 hook entries have no `ev` field; treated as checks)
|
|
9
9
|
* optimize — an optimization was applied {ev: "optimize", src: "cli"|"mcp", saved, model?}
|
|
10
10
|
*/
|
|
11
|
-
import { appendFileSync, existsSync, readFileSync, statSync, writeFileSync } from "node:fs";
|
|
11
|
+
import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
|
|
12
12
|
import { homedir } from "node:os";
|
|
13
13
|
import { dirname, join } from "node:path";
|
|
14
14
|
export function statePath() {
|
|
@@ -20,6 +20,9 @@ export function ledgerPath() {
|
|
|
20
20
|
export function recordLedger(entry) {
|
|
21
21
|
const path = ledgerPath();
|
|
22
22
|
try {
|
|
23
|
+
// Claude-Desktop-only machines have no ~/.claude — create it so their
|
|
24
|
+
// optimize events count in `context-doctor report` too.
|
|
25
|
+
mkdirSync(dirname(path), { recursive: true });
|
|
23
26
|
// Cap growth: past ~256KB keep the most recent 500 entries.
|
|
24
27
|
if (existsSync(path) && statSync(path).size > 256 * 1024) {
|
|
25
28
|
const lines = readFileSync(path, "utf8").trimEnd().split("\n");
|
package/dist/mcp.js
CHANGED
|
@@ -30,63 +30,77 @@ import { recordLedger } from "./ledger.js";
|
|
|
30
30
|
// Kept deliberately terse: these ride in EVERY conversation's context, and a
|
|
31
31
|
// context-saving tool must not itself be context overhead (~110 tokens).
|
|
32
32
|
const SERVER_INSTRUCTIONS = `Context hygiene, always: summarize large pastes/tool results instead of carrying them verbatim; reference earlier content, don't re-quote; never inline base64. Past ~30 turns or several large pastes, proactively offer to run profile_context. Any question about tokens, cost, or latency: call profile_context, don't estimate. If optimize_context returns a pruned-turns digest, you write the ≤150-token replacement summary.`;
|
|
33
|
-
const server = new McpServer({ name: "context-doctor", version: "0.3.6" }, { instructions: SERVER_INSTRUCTIONS });
|
|
34
33
|
const STRATEGY_IDS = ["dedupe", "trim-tool-results", "strip-base64", "prune-history"];
|
|
35
|
-
|
|
36
|
-
|
|
37
|
-
|
|
38
|
-
|
|
39
|
-
|
|
40
|
-
|
|
41
|
-
});
|
|
42
|
-
server.tool("
|
|
43
|
-
|
|
44
|
-
|
|
45
|
-
|
|
46
|
-
|
|
47
|
-
|
|
48
|
-
}, async ({ conversation, strategies, keep_recent, max_tool_result_tokens }) => {
|
|
49
|
-
const result = optimizeConversation(conversation, {
|
|
50
|
-
strategies: strategies,
|
|
51
|
-
keepRecent: keep_recent,
|
|
52
|
-
maxToolResultTokens: max_tool_result_tokens,
|
|
34
|
+
/**
|
|
35
|
+
* Build a fully-configured server instance. A factory (not a singleton) so the
|
|
36
|
+
* stateless HTTP mode can hand every request its own server, per the MCP SDK's
|
|
37
|
+
* recommended pattern.
|
|
38
|
+
*/
|
|
39
|
+
function createServer() {
|
|
40
|
+
const server = new McpServer({ name: "context-doctor", version: "0.4.0" }, { instructions: SERVER_INSTRUCTIONS });
|
|
41
|
+
server.tool("profile_context", "Profile an LLM conversation or prompt: token breakdown by category, largest messages, and actionable findings about wasted context (duplicates, oversized tool results, base64 blobs, cache-unfriendly ordering). Accepts OpenAI/Anthropic conversation JSON or raw text. Call this immediately whenever the user asks about token usage, context size, LLM cost, or latency — and proactively offer it once a conversation grows long or accumulates large pasted content.", {
|
|
42
|
+
conversation: z.string().describe("Conversation JSON (OpenAI or Anthropic format, or bare message array) or raw prompt text"),
|
|
43
|
+
model: z.string().optional().describe("Target model name for context-window math, e.g. claude-sonnet-5 or gpt-4o"),
|
|
44
|
+
}, async ({ conversation, model }) => {
|
|
45
|
+
const profile = profileConversation(parseConversation(conversation), model);
|
|
46
|
+
return { content: [{ type: "text", text: renderProfile(profile) }] };
|
|
53
47
|
});
|
|
54
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
61
|
-
|
|
62
|
-
|
|
63
|
-
|
|
64
|
-
|
|
65
|
-
const conversationJson = JSON.stringify(result.conversation);
|
|
66
|
-
const content = [
|
|
67
|
-
{ type: "text", text: summary },
|
|
68
|
-
conversationJson.length <= ECHO_CAP_CHARS
|
|
69
|
-
? { type: "text", text: conversationJson }
|
|
70
|
-
: {
|
|
71
|
-
type: "text",
|
|
72
|
-
text: `[optimized conversation is ${conversationJson.length} chars — too large to echo into this context. ` +
|
|
73
|
-
`Tell the user the savings above and that \`npx context-doctor optimize <file> --out slim.json\` produces the file directly.]`,
|
|
74
|
-
},
|
|
75
|
-
];
|
|
76
|
-
// Host-model summarization: instead of calling an LLM ourselves (which would
|
|
77
|
-
// need an API key), hand the pruned material to the model that invoked this
|
|
78
|
-
// tool and ask IT to write the summary.
|
|
79
|
-
if (result.prunedDigest) {
|
|
80
|
-
content.push({
|
|
81
|
-
type: "text",
|
|
82
|
-
text: "ACTION REQUIRED (you, the assistant calling this tool): the pruned turns are digested below. " +
|
|
83
|
-
"Write a dense factual summary of them (≤150 tokens: decisions, current state, open items, key identifiers) " +
|
|
84
|
-
"and replace the '[context-doctor: ... pruned]' stub message in the conversation above with your summary " +
|
|
85
|
-
"before presenting the result.\n\nPRUNED TURNS DIGEST:\n" + result.prunedDigest,
|
|
48
|
+
server.tool("optimize_context", "Rewrite a conversation to reclaim tokens using deterministic strategies: dedupe repeated content, trim stale tool results, strip base64 blobs, optionally prune old history. Returns the slimmed conversation JSON plus a savings summary. No LLM calls — safe and inspectable. Call this after profile_context finds recoverable waste and the user wants it fixed; add the prune-history strategy only with the user's consent, then write the replacement summary yourself as the result instructs.", {
|
|
49
|
+
conversation: z.string().describe("Conversation JSON (OpenAI or Anthropic format, or bare message array)"),
|
|
50
|
+
strategies: z.array(z.enum(STRATEGY_IDS)).optional()
|
|
51
|
+
.describe("Strategies to apply. Default: dedupe, trim-tool-results, strip-base64. Add prune-history for lossy compaction of old turns."),
|
|
52
|
+
keep_recent: z.number().int().positive().optional().describe("Messages at the tail to leave untouched (default 6)"),
|
|
53
|
+
max_tool_result_tokens: z.number().int().positive().optional().describe("Token budget for trimmed tool results (default 300)"),
|
|
54
|
+
}, async ({ conversation, strategies, keep_recent, max_tool_result_tokens }) => {
|
|
55
|
+
const result = optimizeConversation(conversation, {
|
|
56
|
+
strategies: strategies,
|
|
57
|
+
keepRecent: keep_recent,
|
|
58
|
+
maxToolResultTokens: max_tool_result_tokens,
|
|
86
59
|
});
|
|
87
|
-
|
|
88
|
-
|
|
89
|
-
});
|
|
60
|
+
const saved = result.tokensBefore - result.tokensAfter;
|
|
61
|
+
if (saved > 0) {
|
|
62
|
+
recordLedger({ ev: "optimize", src: "mcp", saved, model: result.conversation?.model });
|
|
63
|
+
}
|
|
64
|
+
const summary = `Saved ~${formatTokens(saved)} tokens (${formatTokens(result.tokensBefore)} → ${formatTokens(result.tokensAfter)}) ` +
|
|
65
|
+
`via ${result.applied.length} change(s):\n` +
|
|
66
|
+
result.applied.map((c) => `- [${c.strategy}] message #${c.messageIndex}: ${c.note} (~${formatTokens(c.tokensSaved)})`).join("\n");
|
|
67
|
+
// Echoing a huge optimized conversation back inline would flood the very
|
|
68
|
+
// context this tool exists to save. Above the cap, return the summary and
|
|
69
|
+
// point at the CLI (compact JSON keeps mid-size results affordable).
|
|
70
|
+
const ECHO_CAP_CHARS = 100_000;
|
|
71
|
+
const conversationJson = JSON.stringify(result.conversation);
|
|
72
|
+
const content = [
|
|
73
|
+
{ type: "text", text: summary },
|
|
74
|
+
conversationJson.length <= ECHO_CAP_CHARS
|
|
75
|
+
? { type: "text", text: conversationJson }
|
|
76
|
+
: {
|
|
77
|
+
type: "text",
|
|
78
|
+
text: `[optimized conversation is ${conversationJson.length} chars — too large to echo into this context. ` +
|
|
79
|
+
`Tell the user the savings above and that \`npx context-doctor optimize <file> --out slim.json\` produces the file directly.]`,
|
|
80
|
+
},
|
|
81
|
+
];
|
|
82
|
+
// Host-model summarization: instead of calling an LLM ourselves (which would
|
|
83
|
+
// need an API key), hand the pruned material to the model that invoked this
|
|
84
|
+
// tool and ask IT to write the summary.
|
|
85
|
+
if (result.prunedDigest) {
|
|
86
|
+
content.push({
|
|
87
|
+
type: "text",
|
|
88
|
+
text: "ACTION REQUIRED (you, the assistant calling this tool): the pruned turns are digested below. " +
|
|
89
|
+
"Write a dense factual summary of them (≤150 tokens: decisions, current state, open items, key identifiers) " +
|
|
90
|
+
"and replace the '[context-doctor: ... pruned]' stub message in the conversation above with your summary " +
|
|
91
|
+
"before presenting the result.\n\nPRUNED TURNS DIGEST:\n" + result.prunedDigest,
|
|
92
|
+
});
|
|
93
|
+
}
|
|
94
|
+
return { content };
|
|
95
|
+
});
|
|
96
|
+
server.tool("context_best_practices", "Get a curated checklist of context-management best practices, optionally specialized for a provider (anthropic, openai).", {
|
|
97
|
+
provider: z.enum(["general", "anthropic", "openai"]).optional().describe("Provider to specialize tips for (default: general)"),
|
|
98
|
+
}, async ({ provider }) => {
|
|
99
|
+
const tips = [...BEST_PRACTICES.general, ...(provider && provider !== "general" ? BEST_PRACTICES[provider] : [])];
|
|
100
|
+
return { content: [{ type: "text", text: tips.map((t, i) => `${i + 1}. ${t}`).join("\n") }] };
|
|
101
|
+
});
|
|
102
|
+
return server;
|
|
103
|
+
}
|
|
90
104
|
const BEST_PRACTICES = {
|
|
91
105
|
general: [
|
|
92
106
|
"Put stable content first (system prompt, tool definitions, reference docs) and volatile content last — prompt caches match byte-identical prefixes only.",
|
|
@@ -106,11 +120,61 @@ const BEST_PRACTICES = {
|
|
|
106
120
|
"Use max_completion_tokens headroom math: input + output must fit the window together.",
|
|
107
121
|
],
|
|
108
122
|
};
|
|
109
|
-
|
|
110
|
-
|
|
111
|
-
|
|
112
|
-
|
|
113
|
-
|
|
114
|
-
|
|
115
|
-
|
|
116
|
-
|
|
123
|
+
// -- Transport dispatch --------------------------------------------------------
|
|
124
|
+
// Default: stdio (Claude Desktop, Claude Code, Cursor spawn us as a child).
|
|
125
|
+
// --http [--port N] [--host H]: streamable-HTTP endpoint at /mcp for clients
|
|
126
|
+
// that connect to a URL instead of spawning a process — ChatGPT developer-mode
|
|
127
|
+
// connectors (which require a reachable URL), web MCP clients, remote setups.
|
|
128
|
+
const argv = process.argv.slice(2);
|
|
129
|
+
if (argv.includes("--http")) {
|
|
130
|
+
const argAfter = (flag) => {
|
|
131
|
+
const i = argv.indexOf(flag);
|
|
132
|
+
return i >= 0 ? argv[i + 1] : undefined;
|
|
133
|
+
};
|
|
134
|
+
const port = Number(argAfter("--port")) > 0 ? Number(argAfter("--port")) : 8808;
|
|
135
|
+
const host = argAfter("--host") ?? "127.0.0.1";
|
|
136
|
+
const { createServer: createHttpServer } = await import("node:http");
|
|
137
|
+
const { StreamableHTTPServerTransport } = await import("@modelcontextprotocol/sdk/server/streamableHttp.js");
|
|
138
|
+
createHttpServer(async (req, res) => {
|
|
139
|
+
try {
|
|
140
|
+
if (req.url === "/health") {
|
|
141
|
+
res.setHeader("content-type", "application/json");
|
|
142
|
+
res.end(JSON.stringify({ ok: true, service: "context-doctor-mcp" }));
|
|
143
|
+
return;
|
|
144
|
+
}
|
|
145
|
+
if (!(req.url ?? "").startsWith("/mcp")) {
|
|
146
|
+
res.statusCode = 404;
|
|
147
|
+
res.end(JSON.stringify({ error: "MCP endpoint is /mcp" }));
|
|
148
|
+
return;
|
|
149
|
+
}
|
|
150
|
+
if (req.method !== "POST") {
|
|
151
|
+
// Stateless mode: no standalone SSE stream, no sessions to delete.
|
|
152
|
+
res.statusCode = 405;
|
|
153
|
+
res.setHeader("allow", "POST");
|
|
154
|
+
res.end(JSON.stringify({ error: "Stateless server: POST /mcp only" }));
|
|
155
|
+
return;
|
|
156
|
+
}
|
|
157
|
+
// Fresh server + transport per request (stateless — nothing shared).
|
|
158
|
+
const server = createServer();
|
|
159
|
+
const transport = new StreamableHTTPServerTransport({ sessionIdGenerator: undefined });
|
|
160
|
+
res.on("close", () => {
|
|
161
|
+
void transport.close();
|
|
162
|
+
void server.close();
|
|
163
|
+
});
|
|
164
|
+
await server.connect(transport);
|
|
165
|
+
await transport.handleRequest(req, res);
|
|
166
|
+
}
|
|
167
|
+
catch (e) {
|
|
168
|
+
if (!res.headersSent)
|
|
169
|
+
res.statusCode = 500;
|
|
170
|
+
res.end(JSON.stringify({ error: e.message }));
|
|
171
|
+
}
|
|
172
|
+
}).listen(port, host, () => {
|
|
173
|
+
console.error(`context-doctor MCP (streamable HTTP) on http://${host}:${port}/mcp`);
|
|
174
|
+
console.error(`ChatGPT developer-mode connectors need a URL their servers can reach — expose this via your host or a tunnel.`);
|
|
175
|
+
});
|
|
176
|
+
}
|
|
177
|
+
else {
|
|
178
|
+
const transport = new StdioServerTransport();
|
|
179
|
+
await createServer().connect(transport);
|
|
180
|
+
}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
/**
|
|
2
|
+
* MCP streamable-HTTP transport: spawn `mcp.js --http`, run the initialize
|
|
3
|
+
* handshake and a tool call over plain HTTP, exactly as a URL-based client
|
|
4
|
+
* (e.g. a ChatGPT developer-mode connector) would.
|
|
5
|
+
*/
|
|
6
|
+
import { test, after } from "node:test";
|
|
7
|
+
import assert from "node:assert/strict";
|
|
8
|
+
import { spawn } from "node:child_process";
|
|
9
|
+
import { join, dirname } from "node:path";
|
|
10
|
+
import { fileURLToPath } from "node:url";
|
|
11
|
+
const mcpPath = join(dirname(fileURLToPath(import.meta.url)), "..", "mcp.js");
|
|
12
|
+
const PORT = 8898;
|
|
13
|
+
const child = spawn(process.execPath, [mcpPath, "--http", "--port", String(PORT)], { stdio: ["ignore", "ignore", "pipe"] });
|
|
14
|
+
await new Promise((resolve, reject) => {
|
|
15
|
+
const timer = setTimeout(() => reject(new Error("HTTP MCP server did not start")), 8000);
|
|
16
|
+
child.stderr.on("data", (d) => {
|
|
17
|
+
if (d.toString().includes("streamable HTTP")) {
|
|
18
|
+
clearTimeout(timer);
|
|
19
|
+
resolve();
|
|
20
|
+
}
|
|
21
|
+
});
|
|
22
|
+
});
|
|
23
|
+
after(() => child.kill());
|
|
24
|
+
async function rpc(body) {
|
|
25
|
+
const res = await fetch(`http://127.0.0.1:${PORT}/mcp`, {
|
|
26
|
+
method: "POST",
|
|
27
|
+
headers: { "content-type": "application/json", accept: "application/json, text/event-stream" },
|
|
28
|
+
body: JSON.stringify(body),
|
|
29
|
+
});
|
|
30
|
+
const text = await res.text();
|
|
31
|
+
// Streamable HTTP may answer as SSE ("data: {...}") or plain JSON.
|
|
32
|
+
const dataLine = text.split("\n").find((l) => l.startsWith("data: "));
|
|
33
|
+
return { status: res.status, json: JSON.parse(dataLine ? dataLine.slice(6) : text) };
|
|
34
|
+
}
|
|
35
|
+
test("initialize over HTTP returns server info + instructions", async () => {
|
|
36
|
+
const { status, json } = await rpc({
|
|
37
|
+
jsonrpc: "2.0",
|
|
38
|
+
id: 1,
|
|
39
|
+
method: "initialize",
|
|
40
|
+
params: { protocolVersion: "2024-11-05", capabilities: {}, clientInfo: { name: "t", version: "1" } },
|
|
41
|
+
});
|
|
42
|
+
assert.equal(status, 200);
|
|
43
|
+
assert.equal(json.result.serverInfo.name, "context-doctor");
|
|
44
|
+
assert.ok(json.result.instructions.includes("Context hygiene"));
|
|
45
|
+
});
|
|
46
|
+
test("tools/call works statelessly over HTTP", async () => {
|
|
47
|
+
const { json } = await rpc({
|
|
48
|
+
jsonrpc: "2.0",
|
|
49
|
+
id: 2,
|
|
50
|
+
method: "tools/call",
|
|
51
|
+
params: {
|
|
52
|
+
name: "profile_context",
|
|
53
|
+
arguments: { conversation: JSON.stringify({ messages: [{ role: "user", content: "hello world" }] }) },
|
|
54
|
+
},
|
|
55
|
+
});
|
|
56
|
+
assert.ok(json.result.content[0].text.includes("CONTEXT DOCTOR"));
|
|
57
|
+
});
|
|
58
|
+
test("health endpoint responds; non-POST is rejected", async () => {
|
|
59
|
+
const health = (await (await fetch(`http://127.0.0.1:${PORT}/health`)).json());
|
|
60
|
+
assert.equal(health.ok, true);
|
|
61
|
+
const get = await fetch(`http://127.0.0.1:${PORT}/mcp`);
|
|
62
|
+
assert.equal(get.status, 405);
|
|
63
|
+
});
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "context-doctor",
|
|
3
|
-
"version": "0.
|
|
3
|
+
"version": "0.4.0",
|
|
4
4
|
"description": "Profile and optimize LLM context windows. See what's eating your tokens and fix it — works with Claude, GPT, Gemini, and any MCP-capable AI app.",
|
|
5
5
|
"keywords": [
|
|
6
6
|
"llm",
|
|
@@ -41,7 +41,7 @@
|
|
|
41
41
|
"build": "tsc && node -e \"const fs=require('fs');['dist/cli.js','dist/mcp.js'].forEach(f=>fs.chmodSync(f,0o755))\"",
|
|
42
42
|
"prepublishOnly": "npm run build",
|
|
43
43
|
"dev": "tsc --watch",
|
|
44
|
-
"test": "npm run build && node --test dist/test/smoke.test.js dist/test/proxy.test.js dist/test/hook.test.js"
|
|
44
|
+
"test": "npm run build && node --test dist/test/smoke.test.js dist/test/proxy.test.js dist/test/hook.test.js dist/test/mcp-http.test.js"
|
|
45
45
|
},
|
|
46
46
|
"dependencies": {
|
|
47
47
|
"@modelcontextprotocol/sdk": "^1.0.0",
|