@vincemakes/kiso-mcp-ext 0.44.0 → 0.45.1

package/README.md

@@ -17,6 +17,11 @@ Servers live in `~/.kiso/mcp.json` (or the project-level `.kiso/mcp.json`
 after the trust gate) — see the kiso README. There is nothing to import;
 the extension reads the config at startup and connects in the background.
 
+A host passes the servers instead: `createMcpExtension({ servers })`, the
+same `mcpServers` map. Then no config file is read and the tool cache is
+not used (it is keyed by server name alone and shared with the CLI), so a
+supplied server's tools appear once it connects.
+
 ## Versioning
 
 The version counter is this package's own. It is pinned exactly by the kiso

package/dist/kiso-mcp.mjs

@@ -18323,12 +18323,13 @@ function kisoHome() {
   return process.env.KISO_HOME ?? join(homedir(), ".kiso");
 }
 function createMcpExtension(opts = {}) {
-  const config2 = readConfig(process.env.KISO_MCP_CONFIG ?? join(kisoHome(), "mcp.json"));
+  const hostServers = opts.servers !== void 0;
+  const config2 = hostServers ? { mcpServers: checkServers(opts.servers, "options.servers must be an object map of server name to config") } : readConfig(process.env.KISO_MCP_CONFIG ?? join(kisoHome(), "mcp.json"));
   const status = [];
   const tools = [];
   const clients = [];
   let connecting = false;
-  const cache = readToolCache(kisoHome());
+  const cache = hostServers ? {} : readToolCache(kisoHome());
   const entries = Object.entries(config2.mcpServers ?? {}).filter(([, server]) => server.disabled !== true);
   if (entries.length > 0) {
     tools.push(statusTool(status));
@@ -18357,15 +18358,17 @@ function createMcpExtension(opts = {}) {
             if (tools[i].name.startsWith(`mcp__${name}__`)) tools.splice(i, 1);
           }
           tools.push(...mapped);
-          writeToolCache(
-            kisoHome(),
-            name,
-            mapped.map((t) => ({
-              name: t.name.slice(`mcp__${name}__`.length),
-              description: t.description,
-              inputSchema: t.parameters
-            }))
-          );
+          if (!hostServers) {
+            writeToolCache(
+              kisoHome(),
+              name,
+              mapped.map((t) => ({
+                name: t.name.slice(`mcp__${name}__`.length),
+                description: t.description,
+                inputSchema: t.parameters
+              }))
+            );
+          }
         },
         (err) => {
           const e = err;
@@ -18451,7 +18454,16 @@ function readConfig(path) {
     throw new Error(`[mcp] ${path} must be an object with an mcpServers map`);
   }
   const cfg = parsed;
-  for (const [name, server] of Object.entries(cfg.mcpServers ?? {})) {
+  checkEntries(cfg.mcpServers ?? {});
+  return cfg;
+}
+function checkServers(servers, notAMap) {
+  if (typeof servers !== "object" || servers === null || Array.isArray(servers)) throw new Error(`[mcp] ${notAMap}`);
+  checkEntries(servers);
+  return servers;
+}
+function checkEntries(servers) {
+  for (const [name, server] of Object.entries(servers)) {
     if (typeof server !== "object" || server === null || Array.isArray(server)) {
       throw new Error(`[mcp] server "${name}" must be an object`);
     }
@@ -18459,7 +18471,6 @@ function readConfig(path) {
       throw new Error(`[mcp] server "${name}" needs a command (stdio) or a url`);
     }
   }
-  return cfg;
 }
 async function connectServer(name, cfg, clients, secretEnvNames = []) {
   const client = new Client({ name: "kiso-mcp", version: "0.1.7" });

package/index.d.ts

@@ -11,8 +11,26 @@ import type { KisoExtension } from "@vincemakes/kiso-core";
  *  authenticate with. Only the host's config knows them, so the host
  *  declares them; every stdio child is spawned without them. Omitted (a
  *  standalone extension load) = the exact-list and suffix rules alone. */
+/** One server, in the mcp.json `mcpServers` shape: a stdio `command`
+ *  (with `args`, `env`, `cwd`) or a remote `url` (with `headers`). */
+export interface McpServerConfig {
+	readonly command?: string;
+	readonly args?: readonly string[];
+	readonly env?: Readonly<Record<string, string>>;
+	readonly cwd?: string;
+	readonly url?: string;
+	readonly headers?: Readonly<Record<string, string>>;
+	readonly disabled?: boolean;
+}
+
 export interface McpExtensionOptions {
 	readonly secretEnvNames?: readonly string[];
+	/** For a host: the servers, keyed by name as in mcp.json. Given (even
+	 *  `{}`), no config file is read ($KISO_MCP_CONFIG and $KISO_HOME/mcp.json
+	 *  are ignored), every entry is validated as a file entry is, and the
+	 *  tool cache is neither read nor written, so a supplied server's tools
+	 *  register when its connect settles. Omitted = the config file, as today. */
+	readonly servers?: Readonly<Record<string, McpServerConfig>>;
 }
 
 declare const createMcpExtension: (opts?: McpExtensionOptions) => KisoExtension | Promise<KisoExtension>;

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@vincemakes/kiso-mcp-ext",
-	"version": "0.44.0",
+	"version": "0.45.1",
 	"description": "kiso official MCP bridge extension \u2014 MCP servers become mcp__ tools, kernel untouched",
 	"type": "module",
 	"license": "MIT",
@@ -24,8 +24,8 @@
 	},
 	"devDependencies": {
 		"@modelcontextprotocol/sdk": "^1.0.0",
-		"@vincemakes/kiso-core": "0.44.0",
-		"@vincemakes/kiso-tools-node": "0.44.0",
+		"@vincemakes/kiso-core": "0.45.1",
+		"@vincemakes/kiso-tools-node": "0.45.1",
 		"@types/node": "^26.1.2",
 		"esbuild": "^0.24.0",
 		"typescript": "^5.7.2",