docdex 0.2.41 → 0.2.43

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # Changelog
 
+## 0.2.43
+- Fix MCP tool schema compatibility with Claude Code by removing top-level anyOf from `docdex_dag_export`.
+- Bump release metadata to 0.2.43.
+
+## 0.2.42
+- Bump release metadata to 0.2.42.
+
 ## 0.2.41
 - Improve Windows npm postinstall UX with a plain setup hint, npm lifecycle non-interactive detection, and no empty cmd window from immediate daemon start.
 - Fix setup TUI menu selection highlighting on Windows terminals.

package/README.md

@@ -148,6 +148,20 @@ If you need to configure your client manually:
 
 ```
 
+**Claude Code (CLI) JSON (`~/.claude.json` or project `.mcp.json`):**
+
+```json
+{
+  "mcpServers": {
+    "docdex": {
+      "type": "http",
+      "url": "http://localhost:28491/v1/mcp"
+    }
+  }
+}
+
+```
+
 **TOML (Codex):**
 
 ```toml

package/assets/agents.md

@@ -1,4 +1,4 @@
----- START OF DOCDEX INFO V0.2.41 ----
+---- START OF DOCDEX INFO V0.2.43 ----
 Docdex URL: http://127.0.0.1:28491
 Use this base URL for Docdex HTTP endpoints.
 Health check endpoint: `GET /healthz` (not `/v1/health`).

package/lib/postinstall_setup.js

@@ -1068,10 +1068,21 @@ function upsertVsCodeInstructions(pathname, instructions, legacyPath) {
   return true;
 }
 
-function upsertMcpServerJson(pathname, url) {
+function upsertMcpServerJson(pathname, url, options = {}) {
   const { value } = readJson(pathname);
   if (typeof value !== "object" || value == null || Array.isArray(value)) return false;
   const root = value;
+  const extra =
+    options &&
+    typeof options === "object" &&
+    options.extra &&
+    typeof options.extra === "object" &&
+    !Array.isArray(options.extra)
+      ? options.extra
+      : {};
+  const extraEntries = Object.entries(extra);
+  const matchesExtras = (entry) =>
+    extraEntries.every(([key, value]) => entry && entry[key] === value);
   const pickSection = () => {
     if (root.mcpServers && typeof root.mcpServers === "object" && !Array.isArray(root.mcpServers)) {
       return { key: "mcpServers", section: root.mcpServers };
@@ -1084,12 +1095,13 @@ function upsertMcpServerJson(pathname, url) {
   if (Array.isArray(root.mcpServers)) {
     const idx = root.mcpServers.findIndex((entry) => entry && entry.name === "docdex");
     if (idx >= 0) {
-      if (root.mcpServers[idx].url === url) return false;
-      root.mcpServers[idx] = { ...root.mcpServers[idx], url };
+      const current = root.mcpServers[idx] || {};
+      if (current.url === url && matchesExtras(current)) return false;
+      root.mcpServers[idx] = { ...current, ...extra, url, name: "docdex" };
       writeJson(pathname, root);
       return true;
     }
-    root.mcpServers.push({ name: "docdex", url });
+    root.mcpServers.push({ ...extra, url, name: "docdex" });
     writeJson(pathname, root);
     return true;
   }
@@ -1100,8 +1112,10 @@ function upsertMcpServerJson(pathname, url) {
   }
   const section = picked ? picked.section : root.mcpServers;
   const current = section.docdex;
-  if (current && current.url === url) return false;
-  section.docdex = { url };
+  if (current && current.url === url && matchesExtras(current)) return false;
+  const base =
+    current && typeof current === "object" && !Array.isArray(current) ? current : {};
+  section.docdex = { ...base, ...extra, url };
   writeJson(pathname, root);
   return true;
 }
@@ -1343,6 +1357,7 @@ function clientConfigPaths() {
     case "win32":
       return {
         claude: path.join(appData, "Claude", "claude_desktop_config.json"),
+        claude_code: path.join(home, ".claude.json"),
         cursor: path.join(userProfile, ".cursor", "mcp.json"),
         windsurf: path.join(userProfile, ".codeium", "windsurf", "mcp_config.json"),
         cline: path.join(appData, "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"),
@@ -1358,6 +1373,7 @@ function clientConfigPaths() {
     case "darwin":
       return {
         claude: path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json"),
+        claude_code: path.join(home, ".claude.json"),
         cursor: path.join(home, ".cursor", "mcp.json"),
         windsurf: path.join(home, ".codeium", "windsurf", "mcp_config.json"),
         cline: path.join(home, "Library", "Application Support", "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"),
@@ -1373,6 +1389,7 @@ function clientConfigPaths() {
     default:
       return {
         claude: path.join(home, ".config", "Claude", "claude_desktop_config.json"),
+        claude_code: path.join(home, ".claude.json"),
         cursor: path.join(home, ".cursor", "mcp.json"),
         windsurf: path.join(home, ".codeium", "windsurf", "mcp_config.json"),
         cline: path.join(home, ".config", "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"),
@@ -2733,7 +2750,7 @@ async function runPostInstallSetup({ binaryPath, logger, env, skipDaemon, distBa
   }
 
   const url = configUrlForPort(port);
-  const codexUrl = configStreamableUrlForPort(port);
+  const httpUrl = configStreamableUrlForPort(port);
   const paths = clientConfigPaths();
   const jsonPaths = [
     paths.claude,
@@ -2750,10 +2767,13 @@ async function runPostInstallSetup({ binaryPath, logger, env, skipDaemon, distBa
   for (const jsonPath of jsonPaths) {
     upsertMcpServerJson(jsonPath, url);
   }
+  if (paths.claude_code) {
+    upsertMcpServerJson(paths.claude_code, httpUrl, { extra: { type: "http" } });
+  }
   if (paths.zed) {
     upsertZedConfig(paths.zed, url);
   }
-  upsertCodexConfig(paths.codex, codexUrl);
+  upsertCodexConfig(paths.codex, httpUrl);
   applyAgentInstructions({ logger: log });
   if (startupOk) {
     clearStartupFailure();

package/lib/uninstall.js

@@ -153,6 +153,7 @@ function clientConfigPaths() {
       return {
         json: [
           path.join(appData, "Claude", "claude_desktop_config.json"),
+          path.join(home, ".claude.json"),
           path.join(userProfile, ".cursor", "mcp.json"),
           path.join(userProfile, ".codeium", "windsurf", "mcp_config.json"),
           path.join(appData, "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"),
@@ -171,6 +172,7 @@ function clientConfigPaths() {
       return {
         json: [
           path.join(home, "Library", "Application Support", "Claude", "claude_desktop_config.json"),
+          path.join(home, ".claude.json"),
           path.join(home, ".cursor", "mcp.json"),
           path.join(home, ".codeium", "windsurf", "mcp_config.json"),
           path.join(home, "Library", "Application Support", "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"),
@@ -189,6 +191,7 @@ function clientConfigPaths() {
       return {
         json: [
           path.join(home, ".config", "Claude", "claude_desktop_config.json"),
+          path.join(home, ".claude.json"),
           path.join(home, ".cursor", "mcp.json"),
           path.join(home, ".codeium", "windsurf", "mcp_config.json"),
           path.join(home, ".config", "Code", "User", "globalStorage", "saoudrizwan.claude-dev", "settings", "cline_mcp_settings.json"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "docdex",
-  "version": "0.2.41",
+  "version": "0.2.43",
   "mcpName": "io.github.bekirdag/docdex",
   "description": "Local-first documentation and code indexer with HTTP/MCP search, AST, and agent memory.",
   "bin": {