feat(mcp-server): add config check mode

Author: vamgan

README.md

@@ -23,6 +23,12 @@ npx agentdispatch-mcp --config agentdispatch.config.json
 
 The server loads account profiles, SQLite storage, and configured adapters from `agentdispatch.config.json`.
 
+Before wiring it into an MCP client, validate that the stdio server can load config:
+
+```bash
+npx agentdispatch-mcp --config agentdispatch.config.json --check
+```
+
 Configure `defaults.runtime` for the simple agent path. Agents can then call `spawn_cloud_agent` with only an `instruction`; AgentDispatch resolves provider, account, backend, target mode, framework, and runtime tool defaults from the named runtime profile.
 
 Minimal AWS AgentCore session-mode config:

package-lock.json

@@ -1,6 +1,6 @@
 {
   "name": "@agent-dispatch/mcp-server",
-  "version": "0.1.1",
+  "version": "0.1.2",
   "description": "Provider-neutral MCP server for AgentDispatch.",
   "type": "module",
   "license": "Apache-2.0",

package.json

@@ -1,13 +1,19 @@
 #!/usr/bin/env node
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { createRuntimeServiceFromConfigFile } from "./bootstrap.js";
+import { createRuntimeCheckReport, createRuntimeServiceFromConfigFile } from "./bootstrap.js";
 import { createAgentDispatchMcpServer } from "./index.js";
 
 const configPath = process.argv.includes("--config")
   ? process.argv[process.argv.indexOf("--config") + 1]
   : undefined;
+const checkOnly = process.argv.includes("--check");
 
-const transport = new StdioServerTransport();
 const runtime = await createRuntimeServiceFromConfigFile({ configPath });
+if (checkOnly) {
+  process.stdout.write(`${JSON.stringify(createRuntimeCheckReport(runtime), null, 2)}\n`);
+  process.exit(0);
+}
+
+const transport = new StdioServerTransport();
 const server = createAgentDispatchMcpServer(runtime);
 await server.connect(transport);

src/bin.ts

@@ -29,6 +29,28 @@ export async function createRuntimeServiceFromConfigFile(options: RuntimeBootstr
   return createRuntimeServiceFromConfig(config, options);
 }
 
+export function createRuntimeCheckReport(runtime: RuntimeService) {
+  return {
+    ok: true,
+    providers: runtime.listProviders(),
+    capabilities: runtime.listCapabilities(),
+    accounts: runtime.listAccountProfiles().map((account) => ({
+      name: account.name,
+      provider: account.provider,
+      region: account.region,
+      credentialSource: account.credentialSource
+    })),
+    runtimes: runtime.listRuntimeProfiles().map((runtimeProfile) => ({
+      name: runtimeProfile.name,
+      provider: runtimeProfile.provider,
+      account: runtimeProfile.account,
+      capability: runtimeProfile.capability,
+      backend: runtimeProfile.backend,
+      target: runtimeProfile.target
+    }))
+  };
+}
+
 function createConfiguredAdapters(config: AgentDispatchConfig): BackendAdapter[] {
   const adapters: BackendAdapter[] = [];
   for (const backend of Object.values(config.backends)) {

src/bootstrap.ts

@@ -3,7 +3,7 @@ import { join } from "node:path";
 import { tmpdir } from "node:os";
 import { afterEach, describe, expect, it } from "vitest";
 import type { BackendAdapter } from "@agent-dispatch/core";
-import { createRuntimeServiceFromConfig, loadAgentDispatchConfig } from "../src/index.js";
+import { createRuntimeCheckReport, createRuntimeServiceFromConfig, loadAgentDispatchConfig } from "../src/index.js";
 
 let stateDir: string | undefined;
 
@@ -69,4 +69,46 @@ describe("MCP bootstrap", () => {
 
     expect(runtime.listProviders()).toEqual(["aws"]);
   });
+
+  it("creates a safe stdio preflight report", async () => {
+    stateDir = await mkdtemp(join(tmpdir(), "agentdispatch-mcp-"));
+    const adapter: BackendAdapter = {
+      name: "mock",
+      provider: "aws",
+      capabilities: () => [{ provider: "aws", capability: "agent-runtime", taskTypes: ["agent.run"], targetModes: ["session"] }],
+      resolveTarget: async (request) => ({
+        account: { name: request.accountProfile, provider: request.provider, credentialSource: "test" },
+        target: { provider: request.provider, accountProfile: request.accountProfile, capability: request.capability, backend: "mock", mode: request.target.mode }
+      }),
+      provision: async () => ({}),
+      startTask: async () => ({ result: { ok: true } }),
+      streamEvents: async function* () {},
+      cancel: async () => ({ status: "cancelled" }),
+      cleanup: async () => ({ status: "skipped" })
+    };
+    const runtime = await createRuntimeServiceFromConfig({
+      stateDir,
+      accounts: { "dev-aws": { provider: "aws", region: "us-west-2", credentialSource: "aws-sdk-default", details: { secret: "not-returned" } } },
+      backends: {
+        mock: { provider: "aws", capability: "agent-runtime", adapter: "mock", account: "dev-aws" }
+      },
+      runtimes: {
+        "research-agent": {
+          provider: "aws",
+          account: "dev-aws",
+          capability: "agent-runtime",
+          backend: "mock",
+          target: { mode: "session" }
+        }
+      }
+    }, { adapters: [adapter] });
+
+    expect(createRuntimeCheckReport(runtime)).toMatchObject({
+      ok: true,
+      providers: ["aws"],
+      accounts: [{ name: "dev-aws", provider: "aws", region: "us-west-2", credentialSource: "aws-sdk-default" }],
+      runtimes: [{ name: "research-agent", backend: "mock" }]
+    });
+    expect(JSON.stringify(createRuntimeCheckReport(runtime))).not.toContain("not-returned");
+  });
 });