@prom.codes/context-mcp 0.4.3 → 0.4.4

package/README.md

@@ -2,28 +2,33 @@
 
 prom.codes Context — local-first codebase indexing & retrieval as an MCP server (stdio).
 
-## Quick start
-
-```jsonc
-// Claude Desktop / Cursor MCP config
-{
-  "mcpServers": {
-    "prometheus": {
-      "command": "npx",
-      "args": ["-y", "@prom.codes/context-mcp@latest"],
-      "env": {
-        "PROMETHEUS_API_KEY": "prom_live_…",
-        "PROMETHEUS_WORKSPACE_ROOT": "/absolute/path/to/your/repo"
-      }
-    }
-  }
-}
+## Quick start (Claude Code)
+
+```bash
+claude mcp add context --env PROMETHEUS_API_KEY=prom_live_… -- npx -y @prom.codes/context-mcp@latest
 ```
 
-With a `PROMETHEUS_API_KEY` the server runs in managed mode: it indexes
-your workspace into a local SQLite database (`~/.prometheus/<hash>.db`)
-and embeds via the prom.codes API. Your code never leaves your machine —
-only embedding text transits to the API.
+`claude mcp add` defaults to local scope (just you); add `--scope project` to
+write a committable `.mcp.json`, or `--scope user` for all your projects. Other
+MCP hosts (Cursor, VS Code) use the same command/args in their own config.
+
+## Configuration
+
+- **`PROMETHEUS_API_KEY`** (required for semantic search) — a real key minted at
+  [app.prom.codes/app/api-keys](https://app.prom.codes), shape
+  `prom_live_<tag>_<secret>`. Embeddings route through the managed prom.codes
+  proxy — you never bring your own provider key. Without a valid key, code
+  search **degrades gracefully** to lexical (keyword) + symbol-graph retrieval
+  (no embeddings needed) and every structural tool still works.
+- **Workspace root is auto-detected** — no need to set `PROMETHEUS_WORKSPACE_ROOT`.
+  Claude Code passes the open project via `CLAUDE_PROJECT_DIR`; Cursor/VS Code via
+  the MCP `roots` capability. Set it only to point at a different folder.
+- The index is a local SQLite DB at `~/.prometheus/<hash>.db` (one per project).
+  Your code never leaves your machine — only embedding *text* transits to the proxy.
+
+Tools: `search_code`, `get_symbol`, `find_references`, `find_callers`,
+`find_callees`, `expand_context`, `get_file`, `list_changed_since`,
+`list_workspaces`, `framework_overview`.
 
 ## Native modules
 
@@ -32,6 +37,8 @@ Prebuilt binaries are fetched automatically on the mainstream platforms
 (macOS x64/arm64, Linux x64, Windows x64) — no compiler needed. On other
 platforms (e.g. Linux/Windows arm64) or a Node ABI without a prebuild, install
 C/C++ build tools so the native modules can compile (Windows: VS Build Tools).
+If `npx` skips the native build under a hardened npm (`ignore-scripts=true`),
+install globally once and point Claude Code at the built binary — see the docs.
 Requires Node ≥ 20.10.
 
-Docs: https://prom.codes/docs
+Docs: https://prom.codes/docs/mcp/claude-code

package/dist/bin.js

@@ -8946,7 +8946,7 @@ ${hyp}`;
         if (vectorError !== null)
           return;
         vectorError = err instanceof Error ? err.message : String(err);
-        console.error(`[context-mcp] search_code: vector (semantic) search unavailable \u2014 falling back to lexical + symbol-graph. Likely a missing/invalid embedding API key; set PROMETHEUS_API_KEY (a real minted prom_live_\u2026 key) or a provider key (e.g. VOYAGE_API_KEY) to enable semantic ranking. Cause: ${vectorError}`);
+        console.error(`[context-mcp] search_code: vector (semantic) search unavailable \u2014 falling back to lexical + symbol-graph. Likely a missing/invalid embedding API key; set PROMETHEUS_API_KEY to a real minted prom_live_<tag>_<secret> key (mint at app.prom.codes/app/api-keys) to enable semantic ranking. Cause: ${vectorError}`);
       }
     });
     let ordered = pool;
@@ -8981,7 +8981,7 @@ ${hyp}`;
     };
     if (vectorError !== null) {
       payload.degraded = "lexical+graph-only";
-      payload.note = "Semantic (vector) search was unavailable \u2014 results are lexical (keyword) + symbol-graph only, which can rank less precisely on concept queries. Set a valid embedding key (PROMETHEUS_API_KEY = a real minted prom_live_\u2026 key, or e.g. VOYAGE_API_KEY) to enable semantic ranking.";
+      payload.note = "Semantic (vector) search was unavailable \u2014 results are lexical (keyword) + symbol-graph only, which can rank less precisely on concept queries. Set PROMETHEUS_API_KEY to a real minted prom_live_<tag>_<secret> key (app.prom.codes/app/api-keys) to enable semantic ranking.";
       payload.vectorError = vectorError;
     }
     return textResult(payload);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prom.codes/context-mcp",
-  "version": "0.4.3",
+  "version": "0.4.4",
   "description": "prom.codes Context — local-first codebase indexing & retrieval as an MCP server.",
   "type": "module",
   "bin": {