bcdocker 1.0.0 → 1.0.1

package/dist/server-handlers.js

@@ -0,0 +1,147 @@
+import { runPowerShell, runRawPowerShell, psEscape } from "./executor.js";
+function mcpText(text) {
+    return { content: [{ type: "text", text }] };
+}
+export async function handleListContainers() {
+    const result = await runRawPowerShell(`
+      Import-Module BcContainerHelper -DisableNameChecking -ErrorAction Stop
+      $containers = Get-BcContainers
+      if ($containers.Count -eq 0) {
+        Write-Output "No BC containers found."
+      } else {
+        foreach ($name in $containers) {
+          $status = docker inspect $name --format '{{.State.Status}}' 2>$null
+          Write-Output "$name  [$status]"
+        }
+      }
+    `);
+    return mcpText(result.stdout || "No containers found.");
+}
+export async function handleContainerInfo({ containerName }) {
+    const cn = psEscape(containerName);
+    const result = await runPowerShell(`
+      Import-Module BcContainerHelper -DisableNameChecking -ErrorAction Stop
+      $bcVersion = Get-BcContainerNavVersion -containerOrImageName '${cn}'
+      $webUrl = Get-BCDockerWebClientUrl -ContainerName '${cn}' -UseHttps:$false
+      $status = docker inspect '${cn}' --format '{{.State.Status}}' 2>$null
+      Write-Output "Container  : ${cn}"
+      Write-Output "Status     : $status"
+      Write-Output "BC Version : $bcVersion"
+      Write-Output "Web Client : $webUrl"
+      Write-Output "OData/API  : http://${cn}:7048/BC/api"
+      Write-Output "Dev Service: http://${cn}:7049/BC"
+    `);
+    return mcpText(result.stdout);
+}
+export async function handleCreateContainer({ containerName, version, country, userName, password, memoryLimit, isolation, testToolkit, bypassCDN, licenseFile, }) {
+    const includeToolkit = testToolkit !== "none" ? "$true" : "$false";
+    const libOnly = testToolkit === "libraries" ? "$true" : "$false";
+    const cdn = bypassCDN ? "-BypassCDN" : "";
+    const lic = licenseFile ? `-LicenseFile '${psEscape(licenseFile)}'` : "";
+    const result = await runPowerShell(`
+      New-BCDContainer \`
+        -ContainerName '${psEscape(containerName)}' \`
+        -Version '${psEscape(version)}' \`
+        -Country '${psEscape(country)}' \`
+        -UserName '${psEscape(userName)}' \`
+        -Password '${psEscape(password)}' \`
+        -MemoryLimit '${psEscape(memoryLimit)}' \`
+        -Isolation '${psEscape(isolation)}' \`
+        -IncludeTestToolkit ${includeToolkit} \`
+        -TestLibrariesOnly ${libOnly} \`
+        ${cdn} ${lic}
+    `, 1_800_000);
+    return mcpText(result.stdout || "Container creation complete.");
+}
+export async function handleRemoveContainer({ containerName }) {
+    const result = await runPowerShell(`Remove-BCDContainer -ContainerName '${psEscape(containerName)}'`);
+    return mcpText(result.stdout || `Container '${psEscape(containerName)}' removed.`);
+}
+export async function handleStartContainer({ containerName }) {
+    const result = await runPowerShell(`Start-BCDContainer -ContainerName '${psEscape(containerName)}'`);
+    return mcpText(result.stdout || `Container '${psEscape(containerName)}' started.`);
+}
+export async function handleStopContainer({ containerName }) {
+    const result = await runPowerShell(`Stop-BCDContainer -ContainerName '${psEscape(containerName)}'`);
+    return mcpText(result.stdout || `Container '${psEscape(containerName)}' stopped.`);
+}
+export async function handleRestartContainer({ containerName }) {
+    const result = await runPowerShell(`Restart-BCDContainer -ContainerName '${psEscape(containerName)}'`);
+    return mcpText(result.stdout || `Container '${psEscape(containerName)}' restarted.`);
+}
+export async function handleOpenWebclient({ containerName }) {
+    const result = await runPowerShell(`
+      $url = Get-BCDockerWebClientUrl -ContainerName '${psEscape(containerName)}' -UseHttps:$false
+      Write-Output $url
+    `);
+    return mcpText(result.stdout || "Could not resolve URL.");
+}
+export async function handleListApps({ containerName, publisher, }) {
+    const cn = psEscape(containerName);
+    const filter = publisher ? `| Where-Object { $_.Publisher -eq '${psEscape(publisher)}' }` : "";
+    const result = await runRawPowerShell(`
+      Import-Module BcContainerHelper -DisableNameChecking -ErrorAction Stop
+      $apps = Get-BcContainerAppInfo -containerName '${cn}' -tenant default -tenantSpecificProperties ${filter}
+      $apps | Select-Object Name, Publisher, Version, IsInstalled, Scope |
+        Sort-Object Publisher, Name |
+        Format-Table -AutoSize | Out-String -Width 200
+    `);
+    return mcpText(result.stdout || "No apps found.");
+}
+export async function handleInstallApp({ containerName, appFile, userName, password, }) {
+    const result = await runPowerShell(`
+      $cred = Get-BCCredential -UserName '${psEscape(userName)}' -Password '${psEscape(password)}'
+      Install-BCDApp -ContainerName '${psEscape(containerName)}' -AppFile '${psEscape(appFile)}' -Credential $cred
+    `);
+    return mcpText(result.stdout || "App installed.");
+}
+export async function handleUninstallApp({ containerName, appName, appPublisher, }) {
+    const cn = psEscape(containerName);
+    const an = psEscape(appName);
+    const ap = psEscape(appPublisher);
+    const result = await runRawPowerShell(`
+      Import-Module BcContainerHelper -DisableNameChecking -ErrorAction Stop
+      $allApps = Get-BcContainerAppInfo -containerName '${cn}' -tenant default -tenantSpecificProperties
+      $sorted = Get-BcContainerAppInfo -containerName '${cn}' -tenant default -tenantSpecificProperties -sort DependenciesLast
+      $target = $allApps | Where-Object { $_.Name -eq '${an}' -and $_.Publisher -eq '${ap}' }
+      if (-not $target) { Write-Output "App '${an}' by '${ap}' not found."; exit }
+      foreach ($app in $sorted) {
+        if ($app.Name -eq '${an}' -and $app.Publisher -eq '${ap}' -and $app.IsInstalled) {
+          UnInstall-BcContainerApp -name $app.Name -containerName '${cn}' -publisher $app.Publisher -version $app.Version -force
+          Write-Output "Uninstalled: $($app.Name) v$($app.Version)"
+        }
+      }
+    `);
+    return mcpText(result.stdout || "Uninstall complete.");
+}
+export async function handlePublishProject({ containerName, projectFolder, userName, password, }) {
+    const result = await runPowerShell(`
+      $cred = Get-BCCredential -UserName '${psEscape(userName)}' -Password '${psEscape(password)}'
+      Publish-BCDProject -ContainerName '${psEscape(containerName)}' -ProjectFolder '${psEscape(projectFolder)}' -Credential $cred
+    `, 300_000);
+    return mcpText(result.stdout || "Project compiled and published.");
+}
+export async function handleImportTestToolkit({ containerName, librariesOnly, userName, password, }) {
+    const libPs = librariesOnly ? "$true" : "$false";
+    const result = await runPowerShell(`
+      $cred = Get-BCCredential -UserName '${psEscape(userName)}' -Password '${psEscape(password)}'
+      Import-BCDTestToolkit -ContainerName '${psEscape(containerName)}' -Credential $cred -LibrariesOnly ${libPs}
+    `, 300_000);
+    return mcpText(result.stdout || "Test toolkit imported.");
+}
+export async function handleImportLicense({ containerName, licenseFile, }) {
+    const result = await runPowerShell(`Import-BCDLicense -ContainerName '${psEscape(containerName)}' -LicenseFile '${psEscape(licenseFile)}'`);
+    return mcpText(result.stdout || "License imported.");
+}
+export async function handleRunTests({ containerName, testCodeunitId, testFunctionName, appProjectFolder, userName, password, }) {
+    const params = [`-ContainerName '${psEscape(containerName)}'`];
+    params.push(`-Credential (Get-BCCredential -UserName '${psEscape(userName)}' -Password '${psEscape(password)}')`);
+    if (testCodeunitId)
+        params.push(`-TestCodeunitId ${testCodeunitId}`);
+    if (testFunctionName)
+        params.push(`-TestFunctionName '${psEscape(testFunctionName)}'`);
+    if (appProjectFolder)
+        params.push(`-AppProjectFolder '${psEscape(appProjectFolder)}'`);
+    const result = await runPowerShell(`Invoke-BCDTests ${params.join(" ")}`, 600_000);
+    return mcpText(result.stdout || "Test run complete.");
+}

package/dist/server.d.ts

@@ -1 +1,3 @@
-export {};
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare const server: McpServer;
+export declare function startMcpServer(): Promise<void>;

package/dist/server.js

@@ -1,42 +1,16 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
 import { z } from "zod";
-import { runPowerShell, runRawPowerShell } from "./executor.js";
-const server = new McpServer({
+import * as handlers from "./server-handlers.js";
+export const server = new McpServer({
     name: "bcd",
     version: "1.0.0",
 });
 // ── Container Tools ──────────────────────────────────────
-server.tool("list-containers", "List all Business Central Docker containers with their running status", {}, async () => {
-    const result = await runRawPowerShell(`
-      Import-Module BcContainerHelper -DisableNameChecking -ErrorAction Stop
-      $containers = Get-BcContainers
-      if ($containers.Count -eq 0) {
-        Write-Output "No BC containers found."
-      } else {
-        foreach ($name in $containers) {
-          $status = docker inspect $name --format '{{.State.Status}}' 2>$null
-          Write-Output "$name  [$status]"
-        }
-      }
-    `);
-    return { content: [{ type: "text", text: result.stdout || "No containers found." }] };
-});
-server.tool("container-info", "Get detailed info about a BC container: version, status, and service endpoints", { containerName: z.string().describe("Name of the BC container") }, async ({ containerName }) => {
-    const result = await runRawPowerShell(`
-      Import-Module BcContainerHelper -DisableNameChecking -ErrorAction Stop
-      $bcVersion = Get-BcContainerNavVersion -containerNameOrId '${containerName}'
-      $webUrl = Get-BcContainerUrl -containerName '${containerName}' -useHttps:$false
-      $status = docker inspect '${containerName}' --format '{{.State.Status}}' 2>$null
-      Write-Output "Container  : ${containerName}"
-      Write-Output "Status     : $status"
-      Write-Output "BC Version : $bcVersion"
-      Write-Output "Web Client : $webUrl"
-      Write-Output "OData/API  : http://${containerName}:7048/BC/api"
-      Write-Output "Dev Service: http://${containerName}:7049/BC"
-    `);
-    return { content: [{ type: "text", text: result.stdout }] };
-});
+server.tool("list-containers", "List all Business Central Docker containers with their running status", {}, handlers.handleListContainers);
+server.tool("container-info", "Get detailed info about a BC container: version, status, and service endpoints", { containerName: z.string().describe("Name of the BC container") }, handlers.handleContainerInfo);
 server.tool("create-container", "Create a new Business Central Docker container with test toolkit. Long-running (5-30 min).", {
     containerName: z.string().default("bcsandbox").describe("Docker container name"),
     version: z.string().default("sandbox").describe("BC version: 'sandbox', 'onprem', or specific like '26.0'"),
@@ -48,131 +22,45 @@ server.tool("create-container", "Create a new Business Central Docker container
     testToolkit: z.enum(["none", "libraries", "full"]).default("libraries").describe("Test toolkit: none, libraries (faster), or full (all MS tests)"),
     bypassCDN: z.boolean().default(false).describe("Skip Azure CDN, download from blob storage directly"),
     licenseFile: z.string().optional().describe("Path or URL to .bclicense / .flf license file"),
-}, async ({ containerName, version, country, userName, password, memoryLimit, isolation, testToolkit, bypassCDN, licenseFile }) => {
-    const includeToolkit = testToolkit !== "none" ? "$true" : "$false";
-    const libOnly = testToolkit === "libraries" ? "$true" : "$false";
-    const cdn = bypassCDN ? "-BypassCDN" : "";
-    const lic = licenseFile ? `-LicenseFile '${licenseFile}'` : "";
-    const result = await runPowerShell(`
-      New-BCDContainer \`
-        -ContainerName '${containerName}' \`
-        -Version '${version}' \`
-        -Country '${country}' \`
-        -UserName '${userName}' \`
-        -Password '${password}' \`
-        -MemoryLimit '${memoryLimit}' \`
-        -Isolation '${isolation}' \`
-        -IncludeTestToolkit ${includeToolkit} \`
-        -TestLibrariesOnly ${libOnly} \`
-        ${cdn} ${lic}
-    `, 1_800_000);
-    return { content: [{ type: "text", text: result.stdout || "Container creation complete." }] };
-});
-server.tool("remove-container", "Remove a Business Central Docker container", { containerName: z.string().describe("Name of the container to remove") }, async ({ containerName }) => {
-    const result = await runPowerShell(`Remove-BCDContainer -ContainerName '${containerName}'`);
-    return { content: [{ type: "text", text: result.stdout || `Container '${containerName}' removed.` }] };
-});
-server.tool("start-container", "Start a stopped BC Docker container", { containerName: z.string().describe("Name of the container to start") }, async ({ containerName }) => {
-    const result = await runPowerShell(`Start-BCDContainer -ContainerName '${containerName}'`);
-    return { content: [{ type: "text", text: result.stdout || `Container '${containerName}' started.` }] };
-});
-server.tool("stop-container", "Stop a running BC Docker container", { containerName: z.string().describe("Name of the container to stop") }, async ({ containerName }) => {
-    const result = await runPowerShell(`Stop-BCDContainer -ContainerName '${containerName}'`);
-    return { content: [{ type: "text", text: result.stdout || `Container '${containerName}' stopped.` }] };
-});
-server.tool("restart-container", "Restart a BC Docker container", { containerName: z.string().describe("Name of the container to restart") }, async ({ containerName }) => {
-    const result = await runPowerShell(`Restart-BCDContainer -ContainerName '${containerName}'`);
-    return { content: [{ type: "text", text: result.stdout || `Container '${containerName}' restarted.` }] };
-});
-server.tool("open-webclient", "Open the BC Web Client URL for a container. Returns the URL.", { containerName: z.string().describe("Name of the BC container") }, async ({ containerName }) => {
-    const result = await runRawPowerShell(`
-      Import-Module BcContainerHelper -DisableNameChecking -ErrorAction Stop
-      $url = Get-BcContainerUrl -containerName '${containerName}' -useHttps:$false
-      Write-Output $url
-    `);
-    return { content: [{ type: "text", text: result.stdout || "Could not resolve URL." }] };
-});
+}, handlers.handleCreateContainer);
+server.tool("remove-container", "Remove a Business Central Docker container", { containerName: z.string().describe("Name of the container to remove") }, handlers.handleRemoveContainer);
+server.tool("start-container", "Start a stopped BC Docker container", { containerName: z.string().describe("Name of the container to start") }, handlers.handleStartContainer);
+server.tool("stop-container", "Stop a running BC Docker container", { containerName: z.string().describe("Name of the container to stop") }, handlers.handleStopContainer);
+server.tool("restart-container", "Restart a BC Docker container", { containerName: z.string().describe("Name of the container to restart") }, handlers.handleRestartContainer);
+server.tool("open-webclient", "Open the BC Web Client URL for a container. Returns the URL.", { containerName: z.string().describe("Name of the BC container") }, handlers.handleOpenWebclient);
 // ── App Tools ────────────────────────────────────────────
 server.tool("list-apps", "List all apps installed in a BC container, optionally filtered by publisher", {
     containerName: z.string().describe("Target container name"),
     publisher: z.string().optional().describe("Filter by publisher (e.g. 'Microsoft')"),
-}, async ({ containerName, publisher }) => {
-    const filter = publisher
-        ? `| Where-Object { $_.Publisher -eq '${publisher}' }`
-        : "";
-    const result = await runRawPowerShell(`
-      Import-Module BcContainerHelper -DisableNameChecking -ErrorAction Stop
-      $apps = Get-BcContainerAppInfo -containerName '${containerName}' -tenant default -tenantSpecificProperties ${filter}
-      $apps | Select-Object Name, Publisher, Version, IsInstalled, Scope |
-        Sort-Object Publisher, Name |
-        Format-Table -AutoSize | Out-String -Width 200
-    `);
-    return { content: [{ type: "text", text: result.stdout || "No apps found." }] };
-});
+}, handlers.handleListApps);
 server.tool("install-app", "Publish and install a .app file into a BC container", {
     containerName: z.string().describe("Target container name"),
     appFile: z.string().describe("Full path to the .app file"),
     userName: z.string().default("admin").describe("Admin username"),
     password: z.string().default("P@ssw0rd!").describe("Admin password"),
-}, async ({ containerName, appFile, userName, password }) => {
-    const result = await runPowerShell(`
-      $cred = Get-BCCredential -UserName '${userName}' -Password '${password}'
-      Install-BCDApp -ContainerName '${containerName}' -AppFile '${appFile}' -Credential $cred
-    `);
-    return { content: [{ type: "text", text: result.stdout || "App installed." }] };
-});
+}, handlers.handleInstallApp);
 server.tool("uninstall-app", "Uninstall an app from a BC container by name. Automatically handles dependency order.", {
     containerName: z.string().describe("Target container name"),
     appName: z.string().describe("Name of the app to uninstall"),
     appPublisher: z.string().describe("Publisher of the app"),
-}, async ({ containerName, appName, appPublisher }) => {
-    const result = await runRawPowerShell(`
-      Import-Module BcContainerHelper -DisableNameChecking -ErrorAction Stop
-      $allApps = Get-BcContainerAppInfo -containerName '${containerName}' -tenant default -tenantSpecificProperties
-      $sorted = Get-BcContainerAppInfo -containerName '${containerName}' -tenant default -tenantSpecificProperties -sort DependenciesLast
-      $target = $allApps | Where-Object { $_.Name -eq '${appName}' -and $_.Publisher -eq '${appPublisher}' }
-      if (-not $target) { Write-Output "App '${appName}' by '${appPublisher}' not found."; exit }
-      foreach ($app in $sorted) {
-        if ($app.Name -eq '${appName}' -and $app.Publisher -eq '${appPublisher}' -and $app.IsInstalled) {
-          UnInstall-BcContainerApp -name $app.Name -containerName '${containerName}' -publisher $app.Publisher -version $app.Version -force
-          Write-Output "Uninstalled: $($app.Name) v$($app.Version)"
-        }
-      }
-    `);
-    return { content: [{ type: "text", text: result.stdout || "Uninstall complete." }] };
-});
+}, handlers.handleUninstallApp);
 server.tool("publish-project", "Compile and publish an AL project folder into a BC container", {
     containerName: z.string().describe("Target container name"),
     projectFolder: z.string().describe("Full path to the AL project folder"),
     userName: z.string().default("admin").describe("Admin username"),
     password: z.string().default("P@ssw0rd!").describe("Admin password"),
-}, async ({ containerName, projectFolder, userName, password }) => {
-    const result = await runPowerShell(`
-      $cred = Get-BCCredential -UserName '${userName}' -Password '${password}'
-      Publish-BCDProject -ContainerName '${containerName}' -ProjectFolder '${projectFolder}' -Credential $cred
-    `, 300_000);
-    return { content: [{ type: "text", text: result.stdout || "Project compiled and published." }] };
-});
+}, handlers.handlePublishProject);
 // ── Test & License Tools ─────────────────────────────────
 server.tool("import-test-toolkit", "Import the BC Test Toolkit (libraries only or full framework) into a container", {
     containerName: z.string().describe("Target container name"),
     librariesOnly: z.boolean().default(true).describe("true = just helper libs (faster), false = full MS test codeunits"),
     userName: z.string().default("admin").describe("Admin username"),
     password: z.string().default("P@ssw0rd!").describe("Admin password"),
-}, async ({ containerName, librariesOnly, userName, password }) => {
-    const result = await runPowerShell(`
-      $cred = Get-BCCredential -UserName '${userName}' -Password '${password}'
-      Import-BCDTestToolkit -ContainerName '${containerName}' -Credential $cred -LibrariesOnly $${librariesOnly}
-    `, 300_000);
-    return { content: [{ type: "text", text: result.stdout || "Test toolkit imported." }] };
-});
+}, handlers.handleImportTestToolkit);
 server.tool("import-license", "Import a license file into a BC container", {
     containerName: z.string().describe("Target container name"),
     licenseFile: z.string().describe("Full path or URL to .bclicense / .flf file"),
-}, async ({ containerName, licenseFile }) => {
-    const result = await runPowerShell(`Import-BCDLicense -ContainerName '${containerName}' -LicenseFile '${licenseFile}'`);
-    return { content: [{ type: "text", text: result.stdout || "License imported." }] };
-});
+}, handlers.handleImportLicense);
 server.tool("run-tests", "Run AL tests in a BC container. Can run all tests, a specific codeunit, or compile-and-run from a project folder.", {
     containerName: z.string().default("bcsandbox").describe("Target container name"),
     testCodeunitId: z.number().optional().describe("Specific test codeunit ID (omit for all)"),
@@ -180,24 +68,17 @@ server.tool("run-tests", "Run AL tests in a BC container. Can run all tests, a s
     appProjectFolder: z.string().optional().describe("AL test project folder to compile/publish/run"),
     userName: z.string().default("admin").describe("Admin username"),
     password: z.string().default("P@ssw0rd!").describe("Admin password"),
-}, async ({ containerName, testCodeunitId, testFunctionName, appProjectFolder, userName, password }) => {
-    const params = [`-ContainerName '${containerName}'`];
-    params.push(`-Credential (Get-BCCredential -UserName '${userName}' -Password '${password}')`);
-    if (testCodeunitId)
-        params.push(`-TestCodeunitId ${testCodeunitId}`);
-    if (testFunctionName)
-        params.push(`-TestFunctionName '${testFunctionName}'`);
-    if (appProjectFolder)
-        params.push(`-AppProjectFolder '${appProjectFolder}'`);
-    const result = await runPowerShell(`Invoke-BCDTests ${params.join(" ")}`, 600_000);
-    return { content: [{ type: "text", text: result.stdout || "Test run complete." }] };
-});
+}, handlers.handleRunTests);
 // ── Start ────────────────────────────────────────────────
-async function main() {
+export async function startMcpServer() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
 }
-main().catch((err) => {
-    console.error("MCP server failed:", err);
-    process.exit(1);
-});
+const isMainModule = process.argv[1] &&
+    resolve(fileURLToPath(import.meta.url)) === resolve(process.argv[1]);
+if (isMainModule) {
+    startMcpServer().catch((err) => {
+        console.error("MCP server failed:", err);
+        process.exit(1);
+    });
+}

package/package.json

@@ -1,14 +1,15 @@
 {
   "name": "bcdocker",
-  "version": "1.0.0",
-  "description": "MCP server and CLI for Business Central Docker container management. Create, manage, and test BC containers from your terminal or AI assistant.",
+  "version": "1.0.1",
+  "description": "Node.js MCP server and CLI that drive the BCDocker Toolkit PowerShell module — for AI assistants and scripts.",
   "type": "module",
   "bin": {
-    "bcd": "./dist/cli.js"
+    "bcd": "dist/cli-main.js"
   },
   "main": "./dist/server.js",
   "files": [
-    "dist",
+    "dist/*.js",
+    "dist/*.d.ts",
     "ps",
     "README.md",
     "LICENSE"
@@ -17,6 +18,8 @@
     "build": "tsc",
     "start": "node dist/server.js",
     "cli": "node dist/cli.js",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
     "prepublishOnly": "npm run build"
   },
   "keywords": [
@@ -31,7 +34,7 @@
     "devops",
     "cli"
   ],
-  "author": "Oleksandr (Ciellos)",
+  "author": "olederkach",
   "license": "MIT",
   "repository": {
     "type": "git",
@@ -54,6 +57,8 @@
   },
   "devDependencies": {
     "@types/node": "^22.0.0",
-    "typescript": "^5.7.0"
+    "@vitest/coverage-v8": "^3.0.0",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
   }
 }