bi-agent-kit 0.1.0

package/lib/targets.js

@@ -0,0 +1,216 @@
+import path from "node:path";
+
+function claudeDesktopPath(homedir, platform) {
+  if (platform === "darwin") {
+    return path.join(homedir, "Library", "Application Support", "Claude", "claude_desktop_config.json");
+  }
+  if (platform === "win32") {
+    const appData = process.env.APPDATA || path.join(homedir, "AppData", "Roaming");
+    return path.join(appData, "Claude", "claude_desktop_config.json");
+  }
+  return null;
+}
+
+function vsCodeUserDir(homedir, platform) {
+  if (platform === "darwin") {
+    return path.join(homedir, "Library", "Application Support", "Code", "User");
+  }
+  if (platform === "win32") {
+    const appData = process.env.APPDATA || path.join(homedir, "AppData", "Roaming");
+    return path.join(appData, "Code", "User");
+  }
+  return path.join(homedir, ".config", "Code", "User");
+}
+
+export const TARGET_DEFINITIONS = [
+  {
+    id: "claude-code",
+    rootLevel: true,
+    label: "Claude Code (project)",
+    shape: "json",
+    rootKey: "mcpServers",
+    resolve(cwd) {
+      return path.join(cwd, ".mcp.json");
+    },
+  },
+  {
+    id: "claude-code-user",
+    rootLevel: true,
+    label: "Claude Code (user)",
+    shape: "json",
+    rootKey: "mcpServers",
+    resolve(cwd, homedir) {
+      return path.join(homedir, ".claude.json");
+    },
+  },
+  {
+    id: "claude-desktop",
+    label: "Claude Desktop (user)",
+    shape: "json",
+    rootKey: "mcpServers",
+    resolve(cwd, homedir, platform) {
+      return claudeDesktopPath(homedir, platform);
+    },
+  },
+  {
+    id: "cursor-project",
+    label: "Cursor (project)",
+    shape: "json",
+    rootKey: "mcpServers",
+    resolve(cwd) {
+      return path.join(cwd, ".cursor", "mcp.json");
+    },
+  },
+  {
+    id: "cursor-user",
+    label: "Cursor (user)",
+    shape: "json",
+    rootKey: "mcpServers",
+    resolve(cwd, homedir) {
+      return path.join(homedir, ".cursor", "mcp.json");
+    },
+  },
+  {
+    id: "gemini-project",
+    label: "Gemini CLI (project)",
+    shape: "json",
+    rootKey: "mcpServers",
+    resolve(cwd) {
+      return path.join(cwd, ".gemini", "settings.json");
+    },
+  },
+  {
+    id: "gemini-user",
+    label: "Gemini CLI (user)",
+    shape: "json",
+    rootKey: "mcpServers",
+    resolve(cwd, homedir) {
+      return path.join(homedir, ".gemini", "settings.json");
+    },
+  },
+  {
+    id: "copilot-cli-project",
+    rootLevel: true,
+    label: "GitHub Copilot CLI (project)",
+    shape: "json",
+    rootKey: "mcpServers",
+    resolve(cwd) {
+      return path.join(cwd, ".mcp.json");
+    },
+  },
+  {
+    id: "copilot-cli-user",
+    label: "GitHub Copilot CLI (user)",
+    shape: "json",
+    rootKey: "mcpServers",
+    resolve(cwd, homedir) {
+      return path.join(homedir, ".copilot", "mcp-config.json");
+    },
+  },
+  {
+    id: "copilot-vscode-workspace",
+    label: "GitHub Copilot, VS Code extension (workspace)",
+    shape: "json",
+    rootKey: "servers",
+    resolve(cwd) {
+      return path.join(cwd, ".vscode", "mcp.json");
+    },
+  },
+  {
+    id: "copilot-vscode-user",
+    label: "GitHub Copilot, VS Code extension (user)",
+    shape: "json",
+    rootKey: "servers",
+    resolve(cwd, homedir, platform) {
+      const dir = vsCodeUserDir(homedir, platform);
+      return dir ? path.join(dir, "mcp.json") : null;
+    },
+  },
+  {
+    id: "codex-project",
+    label: "OpenAI Codex CLI (project)",
+    shape: "toml",
+    resolve(cwd) {
+      return path.join(cwd, ".codex", "config.toml");
+    },
+  },
+  {
+    id: "codex-user",
+    label: "OpenAI Codex CLI (user)",
+    shape: "toml",
+    resolve(cwd, homedir) {
+      return path.join(homedir, ".codex", "config.toml");
+    },
+  },
+  {
+    id: "windsurf-user",
+    label: "Windsurf (user)",
+    shape: "json",
+    rootKey: "mcpServers",
+    resolve(cwd, homedir) {
+      return path.join(homedir, ".codeium", "windsurf", "mcp_config.json");
+    },
+  },
+  {
+    id: "roo-code-project",
+    label: "Roo Code (project)",
+    shape: "json",
+    rootKey: "mcpServers",
+    resolve(cwd) {
+      return path.join(cwd, ".roo", "mcp.json");
+    },
+  },
+  {
+    id: "junie-project",
+    label: "JetBrains Junie (project)",
+    shape: "json",
+    rootKey: "mcpServers",
+    resolve(cwd) {
+      return path.join(cwd, ".junie", "mcp", "mcp.json");
+    },
+  },
+  {
+    id: "junie-user",
+    label: "JetBrains Junie (user)",
+    shape: "json",
+    rootKey: "mcpServers",
+    resolve(cwd, homedir) {
+      return path.join(homedir, ".junie", "mcp", "mcp.json");
+    },
+  },
+];
+
+export function resolveTargets(cwd, homedir, platform) {
+  const resolved = [];
+  for (const def of TARGET_DEFINITIONS) {
+    const absPath = def.resolve(cwd, homedir, platform);
+    if (!absPath) continue;
+    resolved.push({
+      id: def.id,
+      label: def.label,
+      shape: def.shape,
+      rootKey: def.rootKey,
+      rootLevel: Boolean(def.rootLevel),
+      absPath,
+    });
+  }
+  const groups = new Map();
+  for (const target of resolved) {
+    if (!groups.has(target.absPath)) {
+      groups.set(target.absPath, []);
+    }
+    groups.get(target.absPath).push(target);
+  }
+  const deduped = [];
+  for (const [absPath, group] of groups) {
+    deduped.push({
+      absPath,
+      shape: group[0].shape,
+      rootKey: group[0].rootKey,
+      rootLevel: group.some((t) => t.rootLevel),
+      targetIds: group.map((t) => t.id),
+      labels: group.map((t) => t.label),
+    });
+  }
+  return deduped;
+}

package/lib/toml-adapter.js

@@ -0,0 +1,79 @@
+import { parse, stringify } from "smol-toml";
+
+export function readTomlServers(fileText) {
+  if (!fileText || fileText.trim().length === 0) return {};
+  const parsed = parse(fileText);
+  if (!parsed || typeof parsed !== "object") return {};
+  const servers = parsed.mcp_servers;
+  if (!servers || typeof servers !== "object") return {};
+  return servers;
+}
+
+function headerMatches(line, header) {
+  const trimmed = line.trim();
+  if (trimmed === header) return true;
+  if (trimmed.startsWith(header)) {
+    const rest = trimmed.slice(header.length).trim();
+    return rest.startsWith("#");
+  }
+  return false;
+}
+
+function isBlockBoundary(line, serverKey) {
+  const trimmed = line.trim();
+  if (!trimmed.startsWith("[")) return false;
+  const subTablePrefix = "[mcp_servers." + serverKey + ".";
+  const subArrayPrefix = "[[mcp_servers." + serverKey + ".";
+  return !trimmed.startsWith(subTablePrefix) && !trimmed.startsWith(subArrayPrefix);
+}
+
+function findServerBlockRange(lines, serverKey) {
+  const header = "[mcp_servers." + serverKey + "]";
+  let start = -1;
+  for (let i = 0; i < lines.length; i++) {
+    if (headerMatches(lines[i], header)) {
+      start = i;
+      break;
+    }
+  }
+  if (start === -1) return null;
+  let end = lines.length;
+  for (let i = start + 1; i < lines.length; i++) {
+    if (isBlockBoundary(lines[i], serverKey)) {
+      end = i;
+      break;
+    }
+  }
+  return { start, end };
+}
+
+export function removeTomlServer(fileText, serverKey) {
+  if (!fileText) return fileText;
+  const lines = fileText.split("\n");
+  const range = findServerBlockRange(lines, serverKey);
+  if (range === null) return fileText;
+  const before = lines.slice(0, range.start);
+  const after = lines.slice(range.end);
+  while (before.length > 0 && before[before.length - 1].trim() === "") {
+    before.pop();
+  }
+  const combined = before.concat(after);
+  return combined.join("\n");
+}
+
+export function setTomlServer(fileText, serverKey, serverValue) {
+  const withoutOldBlock = removeTomlServer(fileText || "", serverKey);
+  const rawSnippet = stringify({ mcp_servers: { [serverKey]: serverValue } });
+  // Drop the bare parent [mcp_servers] header line smol-toml emits: appending it
+  // to a file that already has one produces invalid TOML (table redefinition),
+  // and [mcp_servers.<key>] alone implicitly defines the parent table anyway.
+  const snippet = rawSnippet
+    .split("\n")
+    .filter((line) => line.trim() !== "[mcp_servers]")
+    .join("\n");
+  const base = withoutOldBlock.length > 0 && !withoutOldBlock.endsWith("\n")
+    ? withoutOldBlock + "\n"
+    : withoutOldBlock;
+  const separator = base.length > 0 ? "\n" : "";
+  return base + separator + snippet;
+}

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "bi-agent-kit",
+  "version": "0.1.0",
+  "description": "Installs BI-related MCP server entries into AI coding tool configs, without clobbering anything else already there.",
+  "type": "module",
+  "bin": {
+    "bi-agent-kit": "./bin/cli.js"
+  },
+  "files": [
+    "bin",
+    "lib",
+    "templates"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "test": "node --test"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "business-intelligence",
+    "power-bi",
+    "dataverse",
+    "fabric",
+    "dbt",
+    "snowflake",
+    "postgres",
+    "azure",
+    "ai-agents",
+    "claude-code",
+    "cursor",
+    "copilot",
+    "installer",
+    "cli"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/KAE-Labs/bi-agent-kit.git"
+  },
+  "homepage": "https://github.com/KAE-Labs/bi-agent-kit#readme",
+  "bugs": {
+    "url": "https://github.com/KAE-Labs/bi-agent-kit/issues"
+  },
+  "author": "KAE Labs LLC (https://kaelabs.dev)",
+  "license": "MIT",
+  "publishConfig": {
+    "provenance": true,
+    "access": "public"
+  },
+  "dependencies": {
+    "@clack/prompts": "0.9.1",
+    "smol-toml": "1.3.1",
+    "jsonc-parser": "3.3.1"
+  }
+}

package/templates/azure-mcp.json

@@ -0,0 +1,11 @@
+{
+  "id": "azure",
+  "label": "Azure MCP",
+  "description": "Official Microsoft MCP server for Azure resource management (Storage, Key Vault, Cosmos DB, Azure SQL, and more), using the same credential chain as the az CLI. Actively shipping (beta), npm package @azure/mcp.",
+  "config": {
+    "command": "npx",
+    "args": ["-y", "@azure/mcp@latest", "server", "start"],
+    "env": {}
+  },
+  "notes": "Auth uses the standard Azure credential chain (az login, managed identity, or environment-based service principal credentials). No extra config required in this template for interactive use."
+}

package/templates/dataverse-mcp.json

@@ -0,0 +1,11 @@
+{
+  "id": "dataverse",
+  "label": "Dataverse MCP",
+  "description": "Official Microsoft MCP proxy to the Dataverse hosted MCP endpoint. Generally available, npm package microsoft/dataverse.",
+  "config": {
+    "command": "npx",
+    "args": ["-y", "@microsoft/dataverse", "mcp", "REPLACE_WITH_YOUR_ORG_URL"],
+    "env": {}
+  },
+  "notes": "Replace REPLACE_WITH_YOUR_ORG_URL with your Dataverse environment URL after install, for example https://yourorg.crm.dynamics.com. Auth is interactive OAuth through the prebuilt Dataverse CLI app; a tenant admin must consent to it and enable it per environment first. Tool calls from non Copilot Studio clients bill against Copilot Credits unless the tenant already has qualifying licensing."
+}

package/templates/dbt-mcp.json

@@ -0,0 +1,14 @@
+{
+  "id": "dbt",
+  "label": "dbt MCP",
+  "description": "Official dbt Labs MCP server for build, run, docs, and lineage operations against a dbt project. Actively maintained, package dbt-mcp launched via uvx.",
+  "config": {
+    "command": "uvx",
+    "args": ["dbt-mcp"],
+    "env": {
+      "DBT_PROJECT_DIR": "REPLACE_WITH_ABSOLUTE_PATH_TO_DBT_PROJECT",
+      "DBT_PATH": "REPLACE_WITH_ABSOLUTE_PATH_TO_DBT_EXECUTABLE"
+    }
+  },
+  "notes": "Requires uv installed (https://docs.astral.sh/uv/). Set DBT_PROJECT_DIR and DBT_PATH for local CLI mode after install, or swap the env block for DBT_HOST, DBT_TOKEN, DBT_ACCOUNT_ID, and DBT_PROD_ENV_ID to use dbt Platform mode instead."
+}

package/templates/fabric-mcp.json

@@ -0,0 +1,11 @@
+{
+  "id": "fabric",
+  "label": "Fabric MCP",
+  "description": "Official Microsoft Fabric MCP server exposing Fabric REST APIs, OpenAPI specs, item definitions, and workspace operations. Distinct from the fab command line tool, which has no MCP mode. Npm package microsoft/fabric-mcp.",
+  "config": {
+    "command": "npx",
+    "args": ["-y", "@microsoft/fabric-mcp@latest", "server", "start", "--mode", "all"],
+    "env": {}
+  },
+  "notes": "Auth is interactive sign in at runtime, no environment variables required in this template."
+}

package/templates/pac-cli-mcp.json

@@ -0,0 +1,12 @@
+{
+  "id": "pac-cli",
+  "label": "PAC CLI MCP",
+  "description": "Built in MCP server inside the Power Platform CLI itself, no separate npm package. Generally available feature.",
+  "requiresBinary": "pac",
+  "config": {
+    "command": "pac",
+    "args": ["copilot", "mcp", "--run"],
+    "env": {}
+  },
+  "notes": "Requires the Power Platform CLI to already be installed and on PATH, with an existing pac auth create profile. Search learn.microsoft.com for Power Platform CLI installation if pac is not yet installed."
+}

package/templates/postgres-mcp.json

@@ -0,0 +1,14 @@
+{
+  "id": "postgres",
+  "label": "Postgres MCP",
+  "description": "No first-party Postgres MCP server exists; Anthropic's own reference postgres server was moved to the archived, no-longer-maintained servers repo. This is the best-maintained, most widely-adopted community alternative instead: Postgres MCP Pro by Crystal DBA, package postgres-mcp, works against any Postgres database (not tied to a single cloud vendor).",
+  "requiresBinary": "uvx",
+  "config": {
+    "command": "uvx",
+    "args": ["postgres-mcp", "--access-mode=restricted"],
+    "env": {
+      "DATABASE_URI": "REPLACE_WITH_YOUR_POSTGRES_CONNECTION_STRING"
+    }
+  },
+  "notes": "Requires uv installed (https://docs.astral.sh/uv/). DATABASE_URI format is postgresql://username:password@host:5432/dbname. Defaults to --access-mode=restricted (read-only, safe default for production); swap to --access-mode=unrestricted for full read/write access to modify data and schema in development. Docker is also supported and is what the README recommends when Python environment issues are a concern: docker run -i --rm -e DATABASE_URI crystaldba/postgres-mcp --access-mode=restricted, with DATABASE_URI passed via the env block. For full index-tuning and performance-analysis features, also load the pg_stat_statements and hypopg extensions on the target database."
+}

package/templates/powerbi-mcp.json

@@ -0,0 +1,11 @@
+{
+  "id": "powerbi",
+  "label": "Power BI MCP",
+  "description": "Official Microsoft MCP server for Power BI semantic model authoring, TMSL and TOM operations. Public preview, npm package microsoft/powerbi-modeling-mcp.",
+  "config": {
+    "command": "npx",
+    "args": ["-y", "@microsoft/powerbi-modeling-mcp@latest", "--start"],
+    "env": {}
+  },
+  "notes": "Default auth is interactive sign in. For a service principal instead, add AZURE_CLIENT_ID, AZURE_TENANT_ID, and AZURE_CLIENT_SECRET to the env block after install."
+}

package/templates/snowflake-mcp.json

@@ -0,0 +1,12 @@
+{
+  "id": "snowflake",
+  "label": "Snowflake MCP",
+  "description": "Official Snowflake managed MCP server, replacing the deprecated Snowflake-Labs/mcp community project. Remote and hosted inside your Snowflake account; requires an MCP server object already created via CREATE MCP SERVER before this entry will work.",
+  "config": {
+    "url": "https://REPLACE_WITH_YOUR_ACCOUNT_IDENTIFIER.snowflakecomputing.com/api/v2/databases/REPLACE_WITH_YOUR_DATABASE/schemas/REPLACE_WITH_YOUR_SCHEMA/mcp-servers/REPLACE_WITH_YOUR_MCP_SERVER_NAME",
+    "headers": {
+      "Authorization": "Bearer REPLACE_WITH_YOUR_PAT_TOKEN"
+    }
+  },
+  "notes": "Remote server, not a local launch. Run CREATE MCP SERVER in Snowflake first to create the server object, then fill in the account identifier, database, schema, and server name in the URL. OAuth 2.0 is the recommended auth method for production; the placeholder above shows the simpler PAT quickstart path with a bearer token."
+}

package/templates/sqlserver-mcp.json

@@ -0,0 +1,14 @@
+{
+  "id": "sqlserver",
+  "label": "SQL Server MCP",
+  "description": "Official Microsoft SQL MCP Server, built on Data API Builder. Covers Azure SQL, SQL Server, PostgreSQL, MySQL, and Cosmos DB. Requires the dab CLI (dotnet tool install microsoft.dataapibuilder) already installed and on PATH.",
+  "requiresBinary": "dab",
+  "config": {
+    "command": "dab",
+    "args": ["start", "--mcp-stdio", "role:anonymous", "--loglevel", "error", "--config", "REPLACE_WITH_ABSOLUTE_PATH/dab-config.json"],
+    "env": {
+      "MSSQL_CONNECTION_STRING": "REPLACE_WITH_YOUR_CONNECTION_STRING"
+    }
+  },
+  "notes": "Requires a dab-config.json file (Data API Builder config) already set up alongside your database, see the Data API Builder quickstart docs. The connection string is referenced from dab-config.json via an env reference, not passed directly as a CLI arg."
+}