@bridge_gpt/mcp-server 0.1.4 → 0.1.5

package/README.md

@@ -9,6 +9,7 @@ MCP server for [Bridge API](https://bridgegpt-api.com) — exposes Jira integrat
 | `BAPI_BASE_URL` | Yes | `https://bridgegpt-api.com` | Bridge API base URL |
 | `BAPI_REPO_NAME` | Yes | _(none)_ | Jira project/repository identifier configured in Bridge API |
 | `BAPI_API_KEY` | Yes | _(none)_ | API key obtained from the Bridge API setup UI |
+| `BAPI_PROJECT_ROOT` | No | _(auto-set by --init)_ | Absolute path to project root. Anchors BAPI_DOCS_DIR and BAPI_PIPELINES_DIR resolution. Set automatically by --init. |
 | `BAPI_DOCS_DIR` | No | `docs/tmp` | Local directory for saving plans, critiques, and research reports |
 | `BAPI_PIPELINES_DIR` | No | `.bridge/pipelines` | Directory for user-defined custom pipeline JSON files |
 
@@ -122,7 +123,9 @@ Bridge API ships pre-built slash commands for Claude Code and Cursor. To scaffol
 npx @bridge_gpt/mcp-server --init
 ```
 
-This writes command files to `.claude/commands/` and `.cursor/commands/` in your current directory. Re-run after upgrading the package to get updated commands.
+Run from your project root. `--init` automatically detects MCP config files and sets `BAPI_PROJECT_ROOT` so that local file output works correctly regardless of which AI tool launches the server. It also writes command files to `.claude/commands/` and `.cursor/commands/`. Re-run after upgrading the package to get updated commands.
+
+> **Codex users:** `--init` does not modify `~/.codex/config.toml`. Set `BAPI_PROJECT_ROOT` manually in your Codex MCP config.
 
 ## Available Tools
 

package/build/index.js

@@ -27,8 +27,9 @@ let userPipelineKeys = new Set();
 const BASE_URL = process.env.BAPI_BASE_URL ?? "https://bridgegpt-api.com";
 const REPO_NAME = process.env.BAPI_REPO_NAME ?? "";
 const API_KEY = process.env.BAPI_API_KEY ?? "";
-const BAPI_DOCS_DIR = path.resolve(process.cwd(), process.env.BAPI_DOCS_DIR ?? "docs/tmp");
-const BAPI_PIPELINES_DIR = path.resolve(process.cwd(), process.env.BAPI_PIPELINES_DIR ?? ".bridge/pipelines");
+const PROJECT_ROOT = process.env.BAPI_PROJECT_ROOT ?? process.cwd();
+const BAPI_DOCS_DIR = path.resolve(PROJECT_ROOT, process.env.BAPI_DOCS_DIR ?? "docs/tmp");
+const BAPI_PIPELINES_DIR = path.resolve(PROJECT_ROOT, process.env.BAPI_PIPELINES_DIR ?? ".bridge/pipelines");
 const GET_HEADERS = { "X-API-Key": API_KEY };
 const POST_HEADERS = {
     "X-API-Key": API_KEY,
@@ -208,6 +209,15 @@ async function pollForResult(getUrl, timeoutMs, label) {
 // CLI: --init scaffolds slash commands into the current project
 // ---------------------------------------------------------------------------
 if (process.argv.includes("--init")) {
+    // Guard: must be run from project root
+    try {
+        await stat(path.join(process.cwd(), "package.json"));
+    }
+    catch {
+        console.error("Error: No package.json found in current directory.\n" +
+            "--init must be run from your project root (the directory containing package.json).");
+        process.exit(1);
+    }
     try {
         const cwd = process.cwd();
         const dirs = [
@@ -369,6 +379,51 @@ automatically provided by the server.
             console.log(`  ${path.relative(cwd, examplePath)} (written)`);
         }
         console.log(`  ${path.relative(cwd, instrDir)}/ (ensured)`);
+        // Inject BAPI_PROJECT_ROOT into detected MCP config files
+        const projectRoot = cwd;
+        const configTargets = [
+            { path: path.join(cwd, ".mcp.json"), serverKeyPath: ["mcpServers", "bridge-api"] },
+            { path: path.join(cwd, ".vscode", "mcp.json"), serverKeyPath: ["servers", "bridge-api"] },
+        ];
+        const injectedConfigs = [];
+        for (const target of configTargets) {
+            try {
+                const raw = await readFile(target.path, "utf-8");
+                let parsed;
+                try {
+                    parsed = JSON.parse(raw);
+                }
+                catch {
+                    console.warn(`  Warning: ${target.path} is not valid JSON — skipping`);
+                    continue;
+                }
+                // Navigate to server entry
+                let serverEntry = parsed;
+                for (const key of target.serverKeyPath) {
+                    serverEntry = serverEntry?.[key];
+                }
+                if (!serverEntry)
+                    continue;
+                // Ensure env object exists
+                if (!serverEntry.env)
+                    serverEntry.env = {};
+                const action = serverEntry.env.BAPI_PROJECT_ROOT ? "updated" : "injected";
+                serverEntry.env.BAPI_PROJECT_ROOT = projectRoot;
+                await writeFile(target.path, JSON.stringify(parsed, null, 2) + "\n", "utf-8");
+                injectedConfigs.push(`  ${target.path} (${action})`);
+            }
+            catch {
+                // File doesn't exist — skip silently
+            }
+        }
+        if (injectedConfigs.length > 0) {
+            console.log(`Bridge API: set BAPI_PROJECT_ROOT in ${injectedConfigs.length} config file(s)`);
+            for (const line of injectedConfigs)
+                console.log(line);
+        }
+        else {
+            console.log("Bridge API: no MCP config files found — set BAPI_PROJECT_ROOT manually in your MCP server config");
+        }
         process.exit(0);
     }
     catch (err) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bridge_gpt/mcp-server",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "Bridge API MCP server — exposes Jira endpoints as MCP tools for Claude Code agents",
   "license": "MIT",
   "type": "module",