dynmcp 0.0.1

package/README.md

@@ -0,0 +1,34 @@
+# dynmcp
+
+A proxy MCP that exposes meta-tools so agents can discover and call upstream MCP tools on demand, without loading every tool schema into the context window.
+
+## The Problem
+
+Large MCPs routinely expose tens to hundreds of tools. When several are active at once, every tool schema is injected into the context window on every request regardless of relevance — degrading decision quality and consuming tokens unnecessarily. For any given task, only a small subset of tools is actually relevant.
+
+## How It Works
+
+`dynmcp` sits in front of an upstream MCP and exposes exactly two tools:
+
+- **`discover_tool`** — its description contains a compact catalog of every upstream tool (name and one-line summary). Call it with a tool name to get that tool's full schema: description, parameters, types, and required fields.
+- **`use_tool`** — executes a tool by name, proxying the call to the upstream MCP and returning its output unchanged.
+
+The agent workflow: scan the catalog in `discover_tool`'s description to find relevant tools, call `discover_tool` to load the full schema of the one it needs, then call `use_tool` to execute it. Full schemas of tools the agent never needs never enter the context window.
+
+`dynmcp` runs locally, communicating with both the agent host and the upstream MCP over stdio.
+
+## Usage
+
+Requires Node.js >= 20.
+
+Prefix any MCP invocation with `dynmcp --`:
+
+```bash
+# Before
+npx -y chrome-devtools-mcp@latest
+
+# With dynmcp
+npx dynmcp@latest -- npx -y chrome-devtools-mcp@latest
+```
+
+Everything after `--` is the command used to launch the upstream MCP.

package/dist/index.cjs

@@ -0,0 +1,396 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+
+// src/cli.ts
+var import_node_process4 = __toESM(require("process"), 1);
+var import_commander = require("commander");
+
+// package.json
+var package_default = {
+  name: "dynmcp",
+  version: "0.0.1",
+  description: "Dynamic MCP context management tool for AI MCP-enabled agents and clients.",
+  author: "Brandon Burrus <brandon@burrus.io>",
+  license: "MIT",
+  type: "module",
+  homepage: "https://github.com/brandonburrus/dynamic-discovery-mcp#readme",
+  keywords: [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "agent",
+    "proxy",
+    "dynamic",
+    "discovery",
+    "tools",
+    "llm",
+    "cli"
+  ],
+  engines: {
+    node: ">=20.0.0"
+  },
+  publishConfig: {
+    access: "public"
+  },
+  repository: {
+    type: "git",
+    url: "git+https://github.com/brandonburrus/dynamic-discovery-mcp.git"
+  },
+  bugs: {
+    url: "https://github.com/brandonburrus/dynamic-discovery-mcp/issues"
+  },
+  main: "./dist/index.cjs",
+  module: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  bin: {
+    dynmcp: "./dist/index.js"
+  },
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js",
+      require: "./dist/index.cjs"
+    }
+  },
+  files: [
+    "dist"
+  ],
+  scripts: {
+    build: "tsup",
+    dev: "tsx src/index.ts",
+    typecheck: "tsc --noEmit",
+    lint: "biome lint .",
+    format: "biome format --write .",
+    check: "biome check --write .",
+    test: "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    prepare: "husky"
+  },
+  dependencies: {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    boxen: "^8.0.1",
+    chalk: "^5.6.2",
+    commander: "^14.0.3",
+    enquirer: "^2.4.1",
+    fastmcp: "^4.0.1",
+    figlet: "^1.11.0",
+    figures: "^6.1.0",
+    zod: "^4.4.3"
+  },
+  devDependencies: {
+    "@biomejs/biome": "^2.4.15",
+    "@commitlint/cli": "^21.0.1",
+    "@commitlint/config-conventional": "^21.0.1",
+    "@types/node": "^25.9.0",
+    husky: "^9.1.7",
+    tsup: "^8.5.1",
+    tsx: "^4.22.2",
+    typescript: "^6.0.3",
+    vitest: "^4.1.6"
+  }
+};
+
+// src/cli.ts
+var import_figlet = __toESM(require("figlet"), 1);
+var import_chalk = __toESM(require("chalk"), 1);
+
+// src/proxy/index.ts
+var import_node_process3 = __toESM(require("process"), 1);
+
+// src/proxy/tool-catalog.ts
+var DISCOVER_TOOL_PREAMBLE = `Use this tool to look up the full schema of a tool before calling it with use_tool.
+Call discover_tool with a tool name from the list below to get its complete description,
+input parameters, and output schema. Always discover a tool before using it.`;
+var ToolCatalog = class {
+  tools;
+  discoverToolDescription;
+  constructor(upstreamTools) {
+    const toolMap = /* @__PURE__ */ new Map();
+    for (const tool of upstreamTools) {
+      toolMap.set(tool.name, tool);
+    }
+    this.tools = toolMap;
+    this.discoverToolDescription = buildDiscoverToolDescription(upstreamTools);
+  }
+  getToolDetails(toolName) {
+    const tool = this.tools.get(toolName);
+    if (tool === void 0) {
+      const sortedNames = [...this.tools.keys()].sort().join(", ");
+      return `Unknown tool: "${toolName}". Available tools: ${sortedNames}`;
+    }
+    return buildToolDetailsString(tool);
+  }
+};
+function buildDiscoverToolDescription(tools) {
+  const sortedTools = [...tools].sort((a, b) => a.name.localeCompare(b.name));
+  const toolLines = sortedTools.map((tool) => `- ${tool.name}: ${tool.description}`).join("\n");
+  return `${DISCOVER_TOOL_PREAMBLE}
+
+<tools>
+${toolLines}
+</tools>`;
+}
+function buildToolDetailsString(tool) {
+  const lines = [
+    `Tool: ${tool.name}`,
+    `Description: ${tool.description}`,
+    "",
+    "Input Schema:",
+    JSON.stringify(tool.inputSchema, null, 2)
+  ];
+  if (tool.outputSchema !== void 0) {
+    lines.push("", "Output Schema:", JSON.stringify(tool.outputSchema, null, 2));
+  }
+  const annotationLines = buildAnnotationLines(tool);
+  if (annotationLines.length > 0) {
+    lines.push("", "Annotations:", ...annotationLines);
+  }
+  return lines.join("\n");
+}
+function buildAnnotationLines(tool) {
+  if (tool.annotations === void 0) {
+    return [];
+  }
+  const { annotations } = tool;
+  const lines = [];
+  if (annotations.title !== void 0) {
+    lines.push(`- title: ${annotations.title}`);
+  }
+  if (annotations.readOnlyHint !== void 0) {
+    lines.push(`- readOnlyHint: ${annotations.readOnlyHint}`);
+  }
+  if (annotations.destructiveHint !== void 0) {
+    lines.push(`- destructiveHint: ${annotations.destructiveHint}`);
+  }
+  if (annotations.idempotentHint !== void 0) {
+    lines.push(`- idempotentHint: ${annotations.idempotentHint}`);
+  }
+  if (annotations.openWorldHint !== void 0) {
+    lines.push(`- openWorldHint: ${annotations.openWorldHint}`);
+  }
+  return lines;
+}
+
+// src/proxy/server.ts
+var import_node_process = __toESM(require("process"), 1);
+var import_fastmcp = require("fastmcp");
+var import_zod = require("zod");
+var ProxyServer = class {
+  catalog;
+  upstreamClient;
+  constructor({ catalog, upstreamClient }) {
+    this.catalog = catalog;
+    this.upstreamClient = upstreamClient;
+  }
+  async start() {
+    const server = new import_fastmcp.FastMCP({
+      name: "dynamic-discovery-mcp",
+      version: package_default.version
+    });
+    server.addTool({
+      name: "discover_tool",
+      description: this.catalog.discoverToolDescription,
+      parameters: import_zod.z.object({ tool_name: import_zod.z.string() }),
+      execute: async ({ tool_name }) => {
+        return this.catalog.getToolDetails(tool_name);
+      }
+    });
+    server.addTool({
+      name: "use_tool",
+      description: "Use a tool that was previously discovered with the discover_tool tool.",
+      parameters: import_zod.z.object({
+        tool_name: import_zod.z.string(),
+        tool_input: import_zod.z.record(import_zod.z.string(), import_zod.z.unknown()).default({})
+      }),
+      execute: async ({ tool_name, tool_input }) => {
+        if (!this.catalog.tools.has(tool_name)) {
+          return this.catalog.getToolDetails(tool_name);
+        }
+        const result = await this.upstreamClient.callTool(tool_name, tool_input);
+        return result;
+      }
+    });
+    import_node_process.default.stderr.write("Starting dynamic-discovery-mcp server over stdio\n");
+    await server.start({ transportType: "stdio" });
+  }
+};
+
+// src/proxy/upstream-client.ts
+var import_node_process2 = __toESM(require("process"), 1);
+var import_client = require("@modelcontextprotocol/sdk/client/index.js");
+var import_stdio = require("@modelcontextprotocol/sdk/client/stdio.js");
+var UpstreamClient = class {
+  command;
+  args;
+  onTransportError;
+  client = null;
+  transport = null;
+  constructor({ command, args, onTransportError }) {
+    this.command = command;
+    this.args = args;
+    this.onTransportError = onTransportError ?? ((error) => {
+      import_node_process2.default.stderr.write(`Upstream MCP transport error: ${error.message}
+`);
+    });
+  }
+  async connect() {
+    this.transport = new import_stdio.StdioClientTransport({
+      command: this.command,
+      args: this.args
+    });
+    this.transport.onerror = this.onTransportError;
+    this.client = new import_client.Client({ name: "dynamic-discovery-mcp", version: "1.0.0" });
+    await this.client.connect(this.transport);
+  }
+  async listTools() {
+    if (this.client === null) {
+      throw new Error("Client is not connected. Call connect() first.");
+    }
+    const result = await this.client.listTools();
+    return result.tools.map((tool) => {
+      const upstreamTool = {
+        name: tool.name,
+        description: tool.description ?? "",
+        inputSchema: tool.inputSchema
+      };
+      if (tool.outputSchema !== void 0) {
+        upstreamTool.outputSchema = tool.outputSchema;
+      }
+      if (tool.annotations !== void 0) {
+        upstreamTool.annotations = {
+          title: tool.annotations.title,
+          readOnlyHint: tool.annotations.readOnlyHint,
+          destructiveHint: tool.annotations.destructiveHint,
+          idempotentHint: tool.annotations.idempotentHint,
+          openWorldHint: tool.annotations.openWorldHint
+        };
+      }
+      return upstreamTool;
+    });
+  }
+  async callTool(name, input) {
+    if (this.client === null) {
+      throw new Error("Client is not connected. Call connect() first.");
+    }
+    return this.client.callTool({
+      name,
+      arguments: input
+    });
+  }
+  async disconnect() {
+    if (this.client === null) {
+      return;
+    }
+    await this.client.close();
+    this.client = null;
+    this.transport = null;
+  }
+};
+
+// src/proxy/index.ts
+async function startProxy(command, args) {
+  let isShuttingDown = false;
+  const shutdown = (exitCode) => {
+    if (isShuttingDown) return;
+    isShuttingDown = true;
+    upstreamClient.disconnect().catch((error) => {
+      import_node_process3.default.stderr.write(
+        `dynmcp: error during disconnect: ${error instanceof Error ? error.message : String(error)}
+`
+      );
+    }).finally(() => import_node_process3.default.exit(exitCode));
+  };
+  const upstreamClient = new UpstreamClient({
+    command,
+    args,
+    onTransportError: (error) => {
+      import_node_process3.default.stderr.write(`Upstream MCP transport error: ${error.message}
+`);
+      shutdown(1);
+    }
+  });
+  try {
+    await upstreamClient.connect();
+  } catch (error) {
+    import_node_process3.default.stderr.write(`dynmcp: ${error instanceof Error ? error.message : String(error)}
+`);
+    import_node_process3.default.exit(1);
+  }
+  let tools;
+  try {
+    tools = await upstreamClient.listTools();
+  } catch (error) {
+    import_node_process3.default.stderr.write(`dynmcp: ${error instanceof Error ? error.message : String(error)}
+`);
+    import_node_process3.default.exit(1);
+  }
+  const catalog = new ToolCatalog(tools);
+  const proxyServer = new ProxyServer({ catalog, upstreamClient });
+  import_node_process3.default.on("SIGINT", () => shutdown(0));
+  import_node_process3.default.on("SIGTERM", () => shutdown(0));
+  import_node_process3.default.stdin.on("end", () => shutdown(0));
+  import_node_process3.default.stdin.on("close", () => shutdown(0));
+  await proxyServer.start();
+}
+
+// src/cli.ts
+var cliBanner = import_chalk.default.bold.magentaBright(
+  import_figlet.default.textSync("DYNAMIC MCP", {
+    font: "Sub-Zero",
+    horizontalLayout: "fitted",
+    verticalLayout: "fitted"
+  })
+);
+var cli = new import_commander.Command(package_default.name).description(package_default.description).version(package_default.version).addHelpText("beforeAll", cliBanner).addHelpText("after", "\nExample:\n  dynmcp -- npx -y chrome-devtools-mcp@latest\n").allowExcessArguments(true).passThroughOptions(true).action(async () => {
+  const separatorIndex = import_node_process4.default.argv.indexOf("--");
+  if (separatorIndex === -1) {
+    import_node_process4.default.stderr.write(
+      "dynmcp: no upstream command provided.\nUsage: dynmcp -- <command> [args...]\nExample: dynmcp -- npx -y chrome-devtools-mcp@latest\n"
+    );
+    import_node_process4.default.exit(1);
+  }
+  const [command, ...args] = import_node_process4.default.argv.slice(separatorIndex + 1);
+  if (command === void 0) {
+    import_node_process4.default.stderr.write(
+      "dynmcp: no upstream command provided.\nUsage: dynmcp -- <command> [args...]\nExample: dynmcp -- npx -y chrome-devtools-mcp@latest\n"
+    );
+    import_node_process4.default.exit(1);
+  }
+  try {
+    await startProxy(command, args);
+  } catch (error) {
+    import_node_process4.default.stderr.write(`dynmcp: ${error instanceof Error ? error.message : String(error)}
+`);
+    import_node_process4.default.exit(1);
+  }
+});
+
+// src/index.ts
+var import_node_process5 = __toESM(require("process"), 1);
+async function main() {
+  cli.parse(import_node_process5.default.argv);
+}
+main();
+//# sourceMappingURL=index.cjs.map

package/dist/index.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../package.json","../src/proxy/index.ts","../src/proxy/tool-catalog.ts","../src/proxy/server.ts","../src/proxy/upstream-client.ts","../src/index.ts"],"sourcesContent":["import process from \"node:process\";\nimport { Command } from \"commander\";\nimport packageJson from \"../package.json\" with { type: \"json\" };\nimport figlet from \"figlet\";\nimport chalk from \"chalk\";\nimport { startProxy } from \"./proxy/index.js\";\n\nconst cliBanner = chalk.bold.magentaBright(\n  figlet.textSync(\"DYNAMIC MCP\", {\n    font: \"Sub-Zero\",\n    horizontalLayout: \"fitted\",\n    verticalLayout: \"fitted\",\n  }),\n);\n\nexport const cli = new Command(packageJson.name)\n  .description(packageJson.description)\n  .version(packageJson.version)\n  .addHelpText(\"beforeAll\", cliBanner)\n  .addHelpText(\"after\", \"\\nExample:\\n  dynmcp -- npx -y chrome-devtools-mcp@latest\\n\")\n  .allowExcessArguments(true)\n  .passThroughOptions(true)\n  .action(async () => {\n    const separatorIndex = process.argv.indexOf(\"--\");\n\n    if (separatorIndex === -1) {\n      process.stderr.write(\n        \"dynmcp: no upstream command provided.\\n\" +\n          \"Usage: dynmcp -- <command> [args...]\\n\" +\n          \"Example: dynmcp -- npx -y chrome-devtools-mcp@latest\\n\",\n      );\n      process.exit(1);\n    }\n\n    const [command, ...args] = process.argv.slice(separatorIndex + 1);\n\n    if (command === undefined) {\n      process.stderr.write(\n        \"dynmcp: no upstream command provided.\\n\" +\n          \"Usage: dynmcp -- <command> [args...]\\n\" +\n          \"Example: dynmcp -- npx -y chrome-devtools-mcp@latest\\n\",\n      );\n      process.exit(1);\n    }\n\n    try {\n      await startProxy(command, args);\n    } catch (error) {\n      process.stderr.write(`dynmcp: ${error instanceof Error ? error.message : String(error)}\\n`);\n      process.exit(1);\n    }\n  });\n","{\n  \"name\": \"dynmcp\",\n  \"version\": \"0.0.1\",\n  \"description\": \"Dynamic MCP context management tool for AI MCP-enabled agents and clients.\",\n  \"author\": \"Brandon Burrus <brandon@burrus.io>\",\n  \"license\": \"MIT\",\n  \"type\": \"module\",\n  \"homepage\": \"https://github.com/brandonburrus/dynamic-discovery-mcp#readme\",\n  \"keywords\": [\n    \"mcp\",\n    \"model-context-protocol\",\n    \"ai\",\n    \"agent\",\n    \"proxy\",\n    \"dynamic\",\n    \"discovery\",\n    \"tools\",\n    \"llm\",\n    \"cli\"\n  ],\n  \"engines\": {\n    \"node\": \">=20.0.0\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/brandonburrus/dynamic-discovery-mcp.git\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/brandonburrus/dynamic-discovery-mcp/issues\"\n  },\n  \"main\": \"./dist/index.cjs\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"bin\": {\n    \"dynmcp\": \"./dist/index.js\"\n  },\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\",\n      \"require\": \"./dist/index.cjs\"\n    }\n  },\n  \"files\": [\n    \"dist\"\n  ],\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"dev\": \"tsx src/index.ts\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"lint\": \"biome lint .\",\n    \"format\": \"biome format --write .\",\n    \"check\": \"biome check --write .\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\",\n    \"test:coverage\": \"vitest run --coverage\",\n    \"prepare\": \"husky\"\n  },\n  \"dependencies\": {\n    \"@modelcontextprotocol/sdk\": \"^1.29.0\",\n    \"boxen\": \"^8.0.1\",\n    \"chalk\": \"^5.6.2\",\n    \"commander\": \"^14.0.3\",\n    \"enquirer\": \"^2.4.1\",\n    \"fastmcp\": \"^4.0.1\",\n    \"figlet\": \"^1.11.0\",\n    \"figures\": \"^6.1.0\",\n    \"zod\": \"^4.4.3\"\n  },\n  \"devDependencies\": {\n    \"@biomejs/biome\": \"^2.4.15\",\n    \"@commitlint/cli\": \"^21.0.1\",\n    \"@commitlint/config-conventional\": \"^21.0.1\",\n    \"@types/node\": \"^25.9.0\",\n    \"husky\": \"^9.1.7\",\n    \"tsup\": \"^8.5.1\",\n    \"tsx\": \"^4.22.2\",\n    \"typescript\": \"^6.0.3\",\n    \"vitest\": \"^4.1.6\"\n  }\n}\n","import process from \"node:process\";\nimport { ToolCatalog } from \"./tool-catalog.js\";\nimport { ProxyServer } from \"./server.js\";\nimport { UpstreamClient } from \"./upstream-client.js\";\n\nexport async function startProxy(command: string, args: string[]): Promise<void> {\n  let isShuttingDown = false;\n\n  const shutdown = (exitCode: number): void => {\n    if (isShuttingDown) return;\n    isShuttingDown = true;\n\n    upstreamClient\n      .disconnect()\n      .catch((error: unknown) => {\n        process.stderr.write(\n          `dynmcp: error during disconnect: ${error instanceof Error ? error.message : String(error)}\\n`,\n        );\n      })\n      .finally(() => process.exit(exitCode));\n  };\n\n  const upstreamClient = new UpstreamClient({\n    command,\n    args,\n    onTransportError: (error: Error) => {\n      process.stderr.write(`Upstream MCP transport error: ${error.message}\\n`);\n      shutdown(1);\n    },\n  });\n\n  try {\n    await upstreamClient.connect();\n  } catch (error) {\n    process.stderr.write(`dynmcp: ${error instanceof Error ? error.message : String(error)}\\n`);\n    process.exit(1);\n  }\n\n  let tools: Awaited<ReturnType<UpstreamClient[\"listTools\"]>>;\n  try {\n    tools = await upstreamClient.listTools();\n  } catch (error) {\n    process.stderr.write(`dynmcp: ${error instanceof Error ? error.message : String(error)}\\n`);\n    process.exit(1);\n  }\n\n  const catalog = new ToolCatalog(tools);\n  const proxyServer = new ProxyServer({ catalog, upstreamClient });\n\n  process.on(\"SIGINT\", () => shutdown(0));\n  process.on(\"SIGTERM\", () => shutdown(0));\n  process.stdin.on(\"end\", () => shutdown(0));\n  process.stdin.on(\"close\", () => shutdown(0));\n\n  await proxyServer.start();\n}\n","import type { UpstreamTool } from \"./upstream-client.js\";\n\nconst DISCOVER_TOOL_PREAMBLE = `Use this tool to look up the full schema of a tool before calling it with use_tool.\nCall discover_tool with a tool name from the list below to get its complete description,\ninput parameters, and output schema. Always discover a tool before using it.`;\n\nexport class ToolCatalog {\n  readonly tools: ReadonlyMap<string, UpstreamTool>;\n  readonly discoverToolDescription: string;\n\n  constructor(upstreamTools: UpstreamTool[]) {\n    const toolMap = new Map<string, UpstreamTool>();\n    for (const tool of upstreamTools) {\n      toolMap.set(tool.name, tool);\n    }\n    this.tools = toolMap;\n    this.discoverToolDescription = buildDiscoverToolDescription(upstreamTools);\n  }\n\n  getToolDetails(toolName: string): string {\n    const tool = this.tools.get(toolName);\n\n    if (tool === undefined) {\n      const sortedNames = [...this.tools.keys()].sort().join(\", \");\n      return `Unknown tool: \"${toolName}\". Available tools: ${sortedNames}`;\n    }\n\n    return buildToolDetailsString(tool);\n  }\n}\n\nfunction buildDiscoverToolDescription(tools: UpstreamTool[]): string {\n  const sortedTools = [...tools].sort((a, b) => a.name.localeCompare(b.name));\n  const toolLines = sortedTools.map(tool => `- ${tool.name}: ${tool.description}`).join(\"\\n\");\n\n  return `${DISCOVER_TOOL_PREAMBLE}\\n\\n<tools>\\n${toolLines}\\n</tools>`;\n}\n\nfunction buildToolDetailsString(tool: UpstreamTool): string {\n  const lines: string[] = [\n    `Tool: ${tool.name}`,\n    `Description: ${tool.description}`,\n    \"\",\n    \"Input Schema:\",\n    JSON.stringify(tool.inputSchema, null, 2),\n  ];\n\n  if (tool.outputSchema !== undefined) {\n    lines.push(\"\", \"Output Schema:\", JSON.stringify(tool.outputSchema, null, 2));\n  }\n\n  const annotationLines = buildAnnotationLines(tool);\n  if (annotationLines.length > 0) {\n    lines.push(\"\", \"Annotations:\", ...annotationLines);\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction buildAnnotationLines(tool: UpstreamTool): string[] {\n  if (tool.annotations === undefined) {\n    return [];\n  }\n\n  const { annotations } = tool;\n  const lines: string[] = [];\n\n  if (annotations.title !== undefined) {\n    lines.push(`- title: ${annotations.title}`);\n  }\n  if (annotations.readOnlyHint !== undefined) {\n    lines.push(`- readOnlyHint: ${annotations.readOnlyHint}`);\n  }\n  if (annotations.destructiveHint !== undefined) {\n    lines.push(`- destructiveHint: ${annotations.destructiveHint}`);\n  }\n  if (annotations.idempotentHint !== undefined) {\n    lines.push(`- idempotentHint: ${annotations.idempotentHint}`);\n  }\n  if (annotations.openWorldHint !== undefined) {\n    lines.push(`- openWorldHint: ${annotations.openWorldHint}`);\n  }\n\n  return lines;\n}\n","import process from \"node:process\";\nimport { FastMCP } from \"fastmcp\";\nimport { z } from \"zod\";\nimport packageJson from \"../../package.json\" with { type: \"json\" };\nimport type { ToolCatalog } from \"./tool-catalog.js\";\nimport type { UpstreamClient } from \"./upstream-client.js\";\n\ntype ProxyServerConfig = {\n  catalog: ToolCatalog;\n  upstreamClient: UpstreamClient;\n};\n\nexport class ProxyServer {\n  private readonly catalog: ToolCatalog;\n  private readonly upstreamClient: UpstreamClient;\n\n  constructor({ catalog, upstreamClient }: ProxyServerConfig) {\n    this.catalog = catalog;\n    this.upstreamClient = upstreamClient;\n  }\n\n  async start(): Promise<void> {\n    const server = new FastMCP({\n      name: \"dynamic-discovery-mcp\",\n      version: packageJson.version as `${number}.${number}.${number}`,\n    });\n\n    server.addTool({\n      name: \"discover_tool\",\n      description: this.catalog.discoverToolDescription,\n      parameters: z.object({ tool_name: z.string() }),\n      execute: async ({ tool_name }) => {\n        return this.catalog.getToolDetails(tool_name);\n      },\n    });\n\n    server.addTool({\n      name: \"use_tool\",\n      description: \"Use a tool that was previously discovered with the discover_tool tool.\",\n      parameters: z.object({\n        tool_name: z.string(),\n        tool_input: z.record(z.string(), z.unknown()).default({}),\n      }),\n      execute: async ({ tool_name, tool_input }) => {\n        if (!this.catalog.tools.has(tool_name)) {\n          return this.catalog.getToolDetails(tool_name);\n        }\n\n        const result = await this.upstreamClient.callTool(tool_name, tool_input);\n        return result;\n      },\n    });\n\n    process.stderr.write(\"Starting dynamic-discovery-mcp server over stdio\\n\");\n    await server.start({ transportType: \"stdio\" });\n  }\n}\n","import process from \"node:process\";\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport type { ContentResult } from \"fastmcp\";\n\nexport type ToolAnnotations = {\n  title?: string;\n  readOnlyHint?: boolean;\n  destructiveHint?: boolean;\n  idempotentHint?: boolean;\n  openWorldHint?: boolean;\n};\n\nexport type UpstreamTool = {\n  name: string;\n  description: string;\n  inputSchema: unknown;\n  outputSchema?: unknown;\n  annotations?: ToolAnnotations;\n};\n\ntype UpstreamClientConfig = {\n  command: string;\n  args: string[];\n  onTransportError?: (error: Error) => void;\n};\n\nexport class UpstreamClient {\n  private readonly command: string;\n  private readonly args: string[];\n  private readonly onTransportError: (error: Error) => void;\n  private client: Client | null = null;\n  private transport: StdioClientTransport | null = null;\n\n  constructor({ command, args, onTransportError }: UpstreamClientConfig) {\n    this.command = command;\n    this.args = args;\n    this.onTransportError =\n      onTransportError ??\n      ((error: Error) => {\n        process.stderr.write(`Upstream MCP transport error: ${error.message}\\n`);\n      });\n  }\n\n  async connect(): Promise<void> {\n    this.transport = new StdioClientTransport({\n      command: this.command,\n      args: this.args,\n    });\n\n    this.transport.onerror = this.onTransportError;\n\n    this.client = new Client({ name: \"dynamic-discovery-mcp\", version: \"1.0.0\" });\n    await this.client.connect(this.transport);\n  }\n\n  async listTools(): Promise<UpstreamTool[]> {\n    if (this.client === null) {\n      throw new Error(\"Client is not connected. Call connect() first.\");\n    }\n\n    const result = await this.client.listTools();\n\n    return result.tools.map(tool => {\n      const upstreamTool: UpstreamTool = {\n        name: tool.name,\n        description: tool.description ?? \"\",\n        inputSchema: tool.inputSchema,\n      };\n\n      if (tool.outputSchema !== undefined) {\n        upstreamTool.outputSchema = tool.outputSchema;\n      }\n\n      if (tool.annotations !== undefined) {\n        upstreamTool.annotations = {\n          title: tool.annotations.title,\n          readOnlyHint: tool.annotations.readOnlyHint,\n          destructiveHint: tool.annotations.destructiveHint,\n          idempotentHint: tool.annotations.idempotentHint,\n          openWorldHint: tool.annotations.openWorldHint,\n        };\n      }\n\n      return upstreamTool;\n    });\n  }\n\n  async callTool(name: string, input: Record<string, unknown>): Promise<ContentResult> {\n    if (this.client === null) {\n      throw new Error(\"Client is not connected. Call connect() first.\");\n    }\n\n    return this.client.callTool({\n      name,\n      arguments: input,\n    }) as Promise<ContentResult>;\n  }\n\n  async disconnect(): Promise<void> {\n    if (this.client === null) {\n      return;\n    }\n\n    await this.client.close();\n    this.client = null;\n    this.transport = null;\n  }\n}\n","import { cli } from \"./cli.js\";\nimport process from \"node:process\";\n\nasync function main() {\n  cli.parse(process.argv);\n}\n\nmain();\n"],"mappings":"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","names":["import_node_process","import_node_process","process","import_node_process","process","process","chalk","figlet","process","import_node_process","process"]}

package/dist/index.d.cts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+
+export {  }

package/dist/index.js

@@ -0,0 +1,374 @@
+#!/usr/bin/env node
+
+// src/cli.ts
+import process4 from "process";
+import { Command } from "commander";
+
+// package.json
+var package_default = {
+  name: "dynmcp",
+  version: "0.0.1",
+  description: "Dynamic MCP context management tool for AI MCP-enabled agents and clients.",
+  author: "Brandon Burrus <brandon@burrus.io>",
+  license: "MIT",
+  type: "module",
+  homepage: "https://github.com/brandonburrus/dynamic-discovery-mcp#readme",
+  keywords: [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "agent",
+    "proxy",
+    "dynamic",
+    "discovery",
+    "tools",
+    "llm",
+    "cli"
+  ],
+  engines: {
+    node: ">=20.0.0"
+  },
+  publishConfig: {
+    access: "public"
+  },
+  repository: {
+    type: "git",
+    url: "git+https://github.com/brandonburrus/dynamic-discovery-mcp.git"
+  },
+  bugs: {
+    url: "https://github.com/brandonburrus/dynamic-discovery-mcp/issues"
+  },
+  main: "./dist/index.cjs",
+  module: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  bin: {
+    dynmcp: "./dist/index.js"
+  },
+  exports: {
+    ".": {
+      types: "./dist/index.d.ts",
+      import: "./dist/index.js",
+      require: "./dist/index.cjs"
+    }
+  },
+  files: [
+    "dist"
+  ],
+  scripts: {
+    build: "tsup",
+    dev: "tsx src/index.ts",
+    typecheck: "tsc --noEmit",
+    lint: "biome lint .",
+    format: "biome format --write .",
+    check: "biome check --write .",
+    test: "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    prepare: "husky"
+  },
+  dependencies: {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    boxen: "^8.0.1",
+    chalk: "^5.6.2",
+    commander: "^14.0.3",
+    enquirer: "^2.4.1",
+    fastmcp: "^4.0.1",
+    figlet: "^1.11.0",
+    figures: "^6.1.0",
+    zod: "^4.4.3"
+  },
+  devDependencies: {
+    "@biomejs/biome": "^2.4.15",
+    "@commitlint/cli": "^21.0.1",
+    "@commitlint/config-conventional": "^21.0.1",
+    "@types/node": "^25.9.0",
+    husky: "^9.1.7",
+    tsup: "^8.5.1",
+    tsx: "^4.22.2",
+    typescript: "^6.0.3",
+    vitest: "^4.1.6"
+  }
+};
+
+// src/cli.ts
+import figlet from "figlet";
+import chalk from "chalk";
+
+// src/proxy/index.ts
+import process3 from "process";
+
+// src/proxy/tool-catalog.ts
+var DISCOVER_TOOL_PREAMBLE = `Use this tool to look up the full schema of a tool before calling it with use_tool.
+Call discover_tool with a tool name from the list below to get its complete description,
+input parameters, and output schema. Always discover a tool before using it.`;
+var ToolCatalog = class {
+  tools;
+  discoverToolDescription;
+  constructor(upstreamTools) {
+    const toolMap = /* @__PURE__ */ new Map();
+    for (const tool of upstreamTools) {
+      toolMap.set(tool.name, tool);
+    }
+    this.tools = toolMap;
+    this.discoverToolDescription = buildDiscoverToolDescription(upstreamTools);
+  }
+  getToolDetails(toolName) {
+    const tool = this.tools.get(toolName);
+    if (tool === void 0) {
+      const sortedNames = [...this.tools.keys()].sort().join(", ");
+      return `Unknown tool: "${toolName}". Available tools: ${sortedNames}`;
+    }
+    return buildToolDetailsString(tool);
+  }
+};
+function buildDiscoverToolDescription(tools) {
+  const sortedTools = [...tools].sort((a, b) => a.name.localeCompare(b.name));
+  const toolLines = sortedTools.map((tool) => `- ${tool.name}: ${tool.description}`).join("\n");
+  return `${DISCOVER_TOOL_PREAMBLE}
+
+<tools>
+${toolLines}
+</tools>`;
+}
+function buildToolDetailsString(tool) {
+  const lines = [
+    `Tool: ${tool.name}`,
+    `Description: ${tool.description}`,
+    "",
+    "Input Schema:",
+    JSON.stringify(tool.inputSchema, null, 2)
+  ];
+  if (tool.outputSchema !== void 0) {
+    lines.push("", "Output Schema:", JSON.stringify(tool.outputSchema, null, 2));
+  }
+  const annotationLines = buildAnnotationLines(tool);
+  if (annotationLines.length > 0) {
+    lines.push("", "Annotations:", ...annotationLines);
+  }
+  return lines.join("\n");
+}
+function buildAnnotationLines(tool) {
+  if (tool.annotations === void 0) {
+    return [];
+  }
+  const { annotations } = tool;
+  const lines = [];
+  if (annotations.title !== void 0) {
+    lines.push(`- title: ${annotations.title}`);
+  }
+  if (annotations.readOnlyHint !== void 0) {
+    lines.push(`- readOnlyHint: ${annotations.readOnlyHint}`);
+  }
+  if (annotations.destructiveHint !== void 0) {
+    lines.push(`- destructiveHint: ${annotations.destructiveHint}`);
+  }
+  if (annotations.idempotentHint !== void 0) {
+    lines.push(`- idempotentHint: ${annotations.idempotentHint}`);
+  }
+  if (annotations.openWorldHint !== void 0) {
+    lines.push(`- openWorldHint: ${annotations.openWorldHint}`);
+  }
+  return lines;
+}
+
+// src/proxy/server.ts
+import process from "process";
+import { FastMCP } from "fastmcp";
+import { z } from "zod";
+var ProxyServer = class {
+  catalog;
+  upstreamClient;
+  constructor({ catalog, upstreamClient }) {
+    this.catalog = catalog;
+    this.upstreamClient = upstreamClient;
+  }
+  async start() {
+    const server = new FastMCP({
+      name: "dynamic-discovery-mcp",
+      version: package_default.version
+    });
+    server.addTool({
+      name: "discover_tool",
+      description: this.catalog.discoverToolDescription,
+      parameters: z.object({ tool_name: z.string() }),
+      execute: async ({ tool_name }) => {
+        return this.catalog.getToolDetails(tool_name);
+      }
+    });
+    server.addTool({
+      name: "use_tool",
+      description: "Use a tool that was previously discovered with the discover_tool tool.",
+      parameters: z.object({
+        tool_name: z.string(),
+        tool_input: z.record(z.string(), z.unknown()).default({})
+      }),
+      execute: async ({ tool_name, tool_input }) => {
+        if (!this.catalog.tools.has(tool_name)) {
+          return this.catalog.getToolDetails(tool_name);
+        }
+        const result = await this.upstreamClient.callTool(tool_name, tool_input);
+        return result;
+      }
+    });
+    process.stderr.write("Starting dynamic-discovery-mcp server over stdio\n");
+    await server.start({ transportType: "stdio" });
+  }
+};
+
+// src/proxy/upstream-client.ts
+import process2 from "process";
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+var UpstreamClient = class {
+  command;
+  args;
+  onTransportError;
+  client = null;
+  transport = null;
+  constructor({ command, args, onTransportError }) {
+    this.command = command;
+    this.args = args;
+    this.onTransportError = onTransportError ?? ((error) => {
+      process2.stderr.write(`Upstream MCP transport error: ${error.message}
+`);
+    });
+  }
+  async connect() {
+    this.transport = new StdioClientTransport({
+      command: this.command,
+      args: this.args
+    });
+    this.transport.onerror = this.onTransportError;
+    this.client = new Client({ name: "dynamic-discovery-mcp", version: "1.0.0" });
+    await this.client.connect(this.transport);
+  }
+  async listTools() {
+    if (this.client === null) {
+      throw new Error("Client is not connected. Call connect() first.");
+    }
+    const result = await this.client.listTools();
+    return result.tools.map((tool) => {
+      const upstreamTool = {
+        name: tool.name,
+        description: tool.description ?? "",
+        inputSchema: tool.inputSchema
+      };
+      if (tool.outputSchema !== void 0) {
+        upstreamTool.outputSchema = tool.outputSchema;
+      }
+      if (tool.annotations !== void 0) {
+        upstreamTool.annotations = {
+          title: tool.annotations.title,
+          readOnlyHint: tool.annotations.readOnlyHint,
+          destructiveHint: tool.annotations.destructiveHint,
+          idempotentHint: tool.annotations.idempotentHint,
+          openWorldHint: tool.annotations.openWorldHint
+        };
+      }
+      return upstreamTool;
+    });
+  }
+  async callTool(name, input) {
+    if (this.client === null) {
+      throw new Error("Client is not connected. Call connect() first.");
+    }
+    return this.client.callTool({
+      name,
+      arguments: input
+    });
+  }
+  async disconnect() {
+    if (this.client === null) {
+      return;
+    }
+    await this.client.close();
+    this.client = null;
+    this.transport = null;
+  }
+};
+
+// src/proxy/index.ts
+async function startProxy(command, args) {
+  let isShuttingDown = false;
+  const shutdown = (exitCode) => {
+    if (isShuttingDown) return;
+    isShuttingDown = true;
+    upstreamClient.disconnect().catch((error) => {
+      process3.stderr.write(
+        `dynmcp: error during disconnect: ${error instanceof Error ? error.message : String(error)}
+`
+      );
+    }).finally(() => process3.exit(exitCode));
+  };
+  const upstreamClient = new UpstreamClient({
+    command,
+    args,
+    onTransportError: (error) => {
+      process3.stderr.write(`Upstream MCP transport error: ${error.message}
+`);
+      shutdown(1);
+    }
+  });
+  try {
+    await upstreamClient.connect();
+  } catch (error) {
+    process3.stderr.write(`dynmcp: ${error instanceof Error ? error.message : String(error)}
+`);
+    process3.exit(1);
+  }
+  let tools;
+  try {
+    tools = await upstreamClient.listTools();
+  } catch (error) {
+    process3.stderr.write(`dynmcp: ${error instanceof Error ? error.message : String(error)}
+`);
+    process3.exit(1);
+  }
+  const catalog = new ToolCatalog(tools);
+  const proxyServer = new ProxyServer({ catalog, upstreamClient });
+  process3.on("SIGINT", () => shutdown(0));
+  process3.on("SIGTERM", () => shutdown(0));
+  process3.stdin.on("end", () => shutdown(0));
+  process3.stdin.on("close", () => shutdown(0));
+  await proxyServer.start();
+}
+
+// src/cli.ts
+var cliBanner = chalk.bold.magentaBright(
+  figlet.textSync("DYNAMIC MCP", {
+    font: "Sub-Zero",
+    horizontalLayout: "fitted",
+    verticalLayout: "fitted"
+  })
+);
+var cli = new Command(package_default.name).description(package_default.description).version(package_default.version).addHelpText("beforeAll", cliBanner).addHelpText("after", "\nExample:\n  dynmcp -- npx -y chrome-devtools-mcp@latest\n").allowExcessArguments(true).passThroughOptions(true).action(async () => {
+  const separatorIndex = process4.argv.indexOf("--");
+  if (separatorIndex === -1) {
+    process4.stderr.write(
+      "dynmcp: no upstream command provided.\nUsage: dynmcp -- <command> [args...]\nExample: dynmcp -- npx -y chrome-devtools-mcp@latest\n"
+    );
+    process4.exit(1);
+  }
+  const [command, ...args] = process4.argv.slice(separatorIndex + 1);
+  if (command === void 0) {
+    process4.stderr.write(
+      "dynmcp: no upstream command provided.\nUsage: dynmcp -- <command> [args...]\nExample: dynmcp -- npx -y chrome-devtools-mcp@latest\n"
+    );
+    process4.exit(1);
+  }
+  try {
+    await startProxy(command, args);
+  } catch (error) {
+    process4.stderr.write(`dynmcp: ${error instanceof Error ? error.message : String(error)}
+`);
+    process4.exit(1);
+  }
+});
+
+// src/index.ts
+import process5 from "process";
+async function main() {
+  cli.parse(process5.argv);
+}
+main();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cli.ts","../package.json","../src/proxy/index.ts","../src/proxy/tool-catalog.ts","../src/proxy/server.ts","../src/proxy/upstream-client.ts","../src/index.ts"],"sourcesContent":["import process from \"node:process\";\nimport { Command } from \"commander\";\nimport packageJson from \"../package.json\" with { type: \"json\" };\nimport figlet from \"figlet\";\nimport chalk from \"chalk\";\nimport { startProxy } from \"./proxy/index.js\";\n\nconst cliBanner = chalk.bold.magentaBright(\n  figlet.textSync(\"DYNAMIC MCP\", {\n    font: \"Sub-Zero\",\n    horizontalLayout: \"fitted\",\n    verticalLayout: \"fitted\",\n  }),\n);\n\nexport const cli = new Command(packageJson.name)\n  .description(packageJson.description)\n  .version(packageJson.version)\n  .addHelpText(\"beforeAll\", cliBanner)\n  .addHelpText(\"after\", \"\\nExample:\\n  dynmcp -- npx -y chrome-devtools-mcp@latest\\n\")\n  .allowExcessArguments(true)\n  .passThroughOptions(true)\n  .action(async () => {\n    const separatorIndex = process.argv.indexOf(\"--\");\n\n    if (separatorIndex === -1) {\n      process.stderr.write(\n        \"dynmcp: no upstream command provided.\\n\" +\n          \"Usage: dynmcp -- <command> [args...]\\n\" +\n          \"Example: dynmcp -- npx -y chrome-devtools-mcp@latest\\n\",\n      );\n      process.exit(1);\n    }\n\n    const [command, ...args] = process.argv.slice(separatorIndex + 1);\n\n    if (command === undefined) {\n      process.stderr.write(\n        \"dynmcp: no upstream command provided.\\n\" +\n          \"Usage: dynmcp -- <command> [args...]\\n\" +\n          \"Example: dynmcp -- npx -y chrome-devtools-mcp@latest\\n\",\n      );\n      process.exit(1);\n    }\n\n    try {\n      await startProxy(command, args);\n    } catch (error) {\n      process.stderr.write(`dynmcp: ${error instanceof Error ? error.message : String(error)}\\n`);\n      process.exit(1);\n    }\n  });\n","{\n  \"name\": \"dynmcp\",\n  \"version\": \"0.0.1\",\n  \"description\": \"Dynamic MCP context management tool for AI MCP-enabled agents and clients.\",\n  \"author\": \"Brandon Burrus <brandon@burrus.io>\",\n  \"license\": \"MIT\",\n  \"type\": \"module\",\n  \"homepage\": \"https://github.com/brandonburrus/dynamic-discovery-mcp#readme\",\n  \"keywords\": [\n    \"mcp\",\n    \"model-context-protocol\",\n    \"ai\",\n    \"agent\",\n    \"proxy\",\n    \"dynamic\",\n    \"discovery\",\n    \"tools\",\n    \"llm\",\n    \"cli\"\n  ],\n  \"engines\": {\n    \"node\": \">=20.0.0\"\n  },\n  \"publishConfig\": {\n    \"access\": \"public\"\n  },\n  \"repository\": {\n    \"type\": \"git\",\n    \"url\": \"git+https://github.com/brandonburrus/dynamic-discovery-mcp.git\"\n  },\n  \"bugs\": {\n    \"url\": \"https://github.com/brandonburrus/dynamic-discovery-mcp/issues\"\n  },\n  \"main\": \"./dist/index.cjs\",\n  \"module\": \"./dist/index.js\",\n  \"types\": \"./dist/index.d.ts\",\n  \"bin\": {\n    \"dynmcp\": \"./dist/index.js\"\n  },\n  \"exports\": {\n    \".\": {\n      \"types\": \"./dist/index.d.ts\",\n      \"import\": \"./dist/index.js\",\n      \"require\": \"./dist/index.cjs\"\n    }\n  },\n  \"files\": [\n    \"dist\"\n  ],\n  \"scripts\": {\n    \"build\": \"tsup\",\n    \"dev\": \"tsx src/index.ts\",\n    \"typecheck\": \"tsc --noEmit\",\n    \"lint\": \"biome lint .\",\n    \"format\": \"biome format --write .\",\n    \"check\": \"biome check --write .\",\n    \"test\": \"vitest run\",\n    \"test:watch\": \"vitest\",\n    \"test:coverage\": \"vitest run --coverage\",\n    \"prepare\": \"husky\"\n  },\n  \"dependencies\": {\n    \"@modelcontextprotocol/sdk\": \"^1.29.0\",\n    \"boxen\": \"^8.0.1\",\n    \"chalk\": \"^5.6.2\",\n    \"commander\": \"^14.0.3\",\n    \"enquirer\": \"^2.4.1\",\n    \"fastmcp\": \"^4.0.1\",\n    \"figlet\": \"^1.11.0\",\n    \"figures\": \"^6.1.0\",\n    \"zod\": \"^4.4.3\"\n  },\n  \"devDependencies\": {\n    \"@biomejs/biome\": \"^2.4.15\",\n    \"@commitlint/cli\": \"^21.0.1\",\n    \"@commitlint/config-conventional\": \"^21.0.1\",\n    \"@types/node\": \"^25.9.0\",\n    \"husky\": \"^9.1.7\",\n    \"tsup\": \"^8.5.1\",\n    \"tsx\": \"^4.22.2\",\n    \"typescript\": \"^6.0.3\",\n    \"vitest\": \"^4.1.6\"\n  }\n}\n","import process from \"node:process\";\nimport { ToolCatalog } from \"./tool-catalog.js\";\nimport { ProxyServer } from \"./server.js\";\nimport { UpstreamClient } from \"./upstream-client.js\";\n\nexport async function startProxy(command: string, args: string[]): Promise<void> {\n  let isShuttingDown = false;\n\n  const shutdown = (exitCode: number): void => {\n    if (isShuttingDown) return;\n    isShuttingDown = true;\n\n    upstreamClient\n      .disconnect()\n      .catch((error: unknown) => {\n        process.stderr.write(\n          `dynmcp: error during disconnect: ${error instanceof Error ? error.message : String(error)}\\n`,\n        );\n      })\n      .finally(() => process.exit(exitCode));\n  };\n\n  const upstreamClient = new UpstreamClient({\n    command,\n    args,\n    onTransportError: (error: Error) => {\n      process.stderr.write(`Upstream MCP transport error: ${error.message}\\n`);\n      shutdown(1);\n    },\n  });\n\n  try {\n    await upstreamClient.connect();\n  } catch (error) {\n    process.stderr.write(`dynmcp: ${error instanceof Error ? error.message : String(error)}\\n`);\n    process.exit(1);\n  }\n\n  let tools: Awaited<ReturnType<UpstreamClient[\"listTools\"]>>;\n  try {\n    tools = await upstreamClient.listTools();\n  } catch (error) {\n    process.stderr.write(`dynmcp: ${error instanceof Error ? error.message : String(error)}\\n`);\n    process.exit(1);\n  }\n\n  const catalog = new ToolCatalog(tools);\n  const proxyServer = new ProxyServer({ catalog, upstreamClient });\n\n  process.on(\"SIGINT\", () => shutdown(0));\n  process.on(\"SIGTERM\", () => shutdown(0));\n  process.stdin.on(\"end\", () => shutdown(0));\n  process.stdin.on(\"close\", () => shutdown(0));\n\n  await proxyServer.start();\n}\n","import type { UpstreamTool } from \"./upstream-client.js\";\n\nconst DISCOVER_TOOL_PREAMBLE = `Use this tool to look up the full schema of a tool before calling it with use_tool.\nCall discover_tool with a tool name from the list below to get its complete description,\ninput parameters, and output schema. Always discover a tool before using it.`;\n\nexport class ToolCatalog {\n  readonly tools: ReadonlyMap<string, UpstreamTool>;\n  readonly discoverToolDescription: string;\n\n  constructor(upstreamTools: UpstreamTool[]) {\n    const toolMap = new Map<string, UpstreamTool>();\n    for (const tool of upstreamTools) {\n      toolMap.set(tool.name, tool);\n    }\n    this.tools = toolMap;\n    this.discoverToolDescription = buildDiscoverToolDescription(upstreamTools);\n  }\n\n  getToolDetails(toolName: string): string {\n    const tool = this.tools.get(toolName);\n\n    if (tool === undefined) {\n      const sortedNames = [...this.tools.keys()].sort().join(\", \");\n      return `Unknown tool: \"${toolName}\". Available tools: ${sortedNames}`;\n    }\n\n    return buildToolDetailsString(tool);\n  }\n}\n\nfunction buildDiscoverToolDescription(tools: UpstreamTool[]): string {\n  const sortedTools = [...tools].sort((a, b) => a.name.localeCompare(b.name));\n  const toolLines = sortedTools.map(tool => `- ${tool.name}: ${tool.description}`).join(\"\\n\");\n\n  return `${DISCOVER_TOOL_PREAMBLE}\\n\\n<tools>\\n${toolLines}\\n</tools>`;\n}\n\nfunction buildToolDetailsString(tool: UpstreamTool): string {\n  const lines: string[] = [\n    `Tool: ${tool.name}`,\n    `Description: ${tool.description}`,\n    \"\",\n    \"Input Schema:\",\n    JSON.stringify(tool.inputSchema, null, 2),\n  ];\n\n  if (tool.outputSchema !== undefined) {\n    lines.push(\"\", \"Output Schema:\", JSON.stringify(tool.outputSchema, null, 2));\n  }\n\n  const annotationLines = buildAnnotationLines(tool);\n  if (annotationLines.length > 0) {\n    lines.push(\"\", \"Annotations:\", ...annotationLines);\n  }\n\n  return lines.join(\"\\n\");\n}\n\nfunction buildAnnotationLines(tool: UpstreamTool): string[] {\n  if (tool.annotations === undefined) {\n    return [];\n  }\n\n  const { annotations } = tool;\n  const lines: string[] = [];\n\n  if (annotations.title !== undefined) {\n    lines.push(`- title: ${annotations.title}`);\n  }\n  if (annotations.readOnlyHint !== undefined) {\n    lines.push(`- readOnlyHint: ${annotations.readOnlyHint}`);\n  }\n  if (annotations.destructiveHint !== undefined) {\n    lines.push(`- destructiveHint: ${annotations.destructiveHint}`);\n  }\n  if (annotations.idempotentHint !== undefined) {\n    lines.push(`- idempotentHint: ${annotations.idempotentHint}`);\n  }\n  if (annotations.openWorldHint !== undefined) {\n    lines.push(`- openWorldHint: ${annotations.openWorldHint}`);\n  }\n\n  return lines;\n}\n","import process from \"node:process\";\nimport { FastMCP } from \"fastmcp\";\nimport { z } from \"zod\";\nimport packageJson from \"../../package.json\" with { type: \"json\" };\nimport type { ToolCatalog } from \"./tool-catalog.js\";\nimport type { UpstreamClient } from \"./upstream-client.js\";\n\ntype ProxyServerConfig = {\n  catalog: ToolCatalog;\n  upstreamClient: UpstreamClient;\n};\n\nexport class ProxyServer {\n  private readonly catalog: ToolCatalog;\n  private readonly upstreamClient: UpstreamClient;\n\n  constructor({ catalog, upstreamClient }: ProxyServerConfig) {\n    this.catalog = catalog;\n    this.upstreamClient = upstreamClient;\n  }\n\n  async start(): Promise<void> {\n    const server = new FastMCP({\n      name: \"dynamic-discovery-mcp\",\n      version: packageJson.version as `${number}.${number}.${number}`,\n    });\n\n    server.addTool({\n      name: \"discover_tool\",\n      description: this.catalog.discoverToolDescription,\n      parameters: z.object({ tool_name: z.string() }),\n      execute: async ({ tool_name }) => {\n        return this.catalog.getToolDetails(tool_name);\n      },\n    });\n\n    server.addTool({\n      name: \"use_tool\",\n      description: \"Use a tool that was previously discovered with the discover_tool tool.\",\n      parameters: z.object({\n        tool_name: z.string(),\n        tool_input: z.record(z.string(), z.unknown()).default({}),\n      }),\n      execute: async ({ tool_name, tool_input }) => {\n        if (!this.catalog.tools.has(tool_name)) {\n          return this.catalog.getToolDetails(tool_name);\n        }\n\n        const result = await this.upstreamClient.callTool(tool_name, tool_input);\n        return result;\n      },\n    });\n\n    process.stderr.write(\"Starting dynamic-discovery-mcp server over stdio\\n\");\n    await server.start({ transportType: \"stdio\" });\n  }\n}\n","import process from \"node:process\";\nimport { Client } from \"@modelcontextprotocol/sdk/client/index.js\";\nimport { StdioClientTransport } from \"@modelcontextprotocol/sdk/client/stdio.js\";\nimport type { ContentResult } from \"fastmcp\";\n\nexport type ToolAnnotations = {\n  title?: string;\n  readOnlyHint?: boolean;\n  destructiveHint?: boolean;\n  idempotentHint?: boolean;\n  openWorldHint?: boolean;\n};\n\nexport type UpstreamTool = {\n  name: string;\n  description: string;\n  inputSchema: unknown;\n  outputSchema?: unknown;\n  annotations?: ToolAnnotations;\n};\n\ntype UpstreamClientConfig = {\n  command: string;\n  args: string[];\n  onTransportError?: (error: Error) => void;\n};\n\nexport class UpstreamClient {\n  private readonly command: string;\n  private readonly args: string[];\n  private readonly onTransportError: (error: Error) => void;\n  private client: Client | null = null;\n  private transport: StdioClientTransport | null = null;\n\n  constructor({ command, args, onTransportError }: UpstreamClientConfig) {\n    this.command = command;\n    this.args = args;\n    this.onTransportError =\n      onTransportError ??\n      ((error: Error) => {\n        process.stderr.write(`Upstream MCP transport error: ${error.message}\\n`);\n      });\n  }\n\n  async connect(): Promise<void> {\n    this.transport = new StdioClientTransport({\n      command: this.command,\n      args: this.args,\n    });\n\n    this.transport.onerror = this.onTransportError;\n\n    this.client = new Client({ name: \"dynamic-discovery-mcp\", version: \"1.0.0\" });\n    await this.client.connect(this.transport);\n  }\n\n  async listTools(): Promise<UpstreamTool[]> {\n    if (this.client === null) {\n      throw new Error(\"Client is not connected. Call connect() first.\");\n    }\n\n    const result = await this.client.listTools();\n\n    return result.tools.map(tool => {\n      const upstreamTool: UpstreamTool = {\n        name: tool.name,\n        description: tool.description ?? \"\",\n        inputSchema: tool.inputSchema,\n      };\n\n      if (tool.outputSchema !== undefined) {\n        upstreamTool.outputSchema = tool.outputSchema;\n      }\n\n      if (tool.annotations !== undefined) {\n        upstreamTool.annotations = {\n          title: tool.annotations.title,\n          readOnlyHint: tool.annotations.readOnlyHint,\n          destructiveHint: tool.annotations.destructiveHint,\n          idempotentHint: tool.annotations.idempotentHint,\n          openWorldHint: tool.annotations.openWorldHint,\n        };\n      }\n\n      return upstreamTool;\n    });\n  }\n\n  async callTool(name: string, input: Record<string, unknown>): Promise<ContentResult> {\n    if (this.client === null) {\n      throw new Error(\"Client is not connected. Call connect() first.\");\n    }\n\n    return this.client.callTool({\n      name,\n      arguments: input,\n    }) as Promise<ContentResult>;\n  }\n\n  async disconnect(): Promise<void> {\n    if (this.client === null) {\n      return;\n    }\n\n    await this.client.close();\n    this.client = null;\n    this.transport = null;\n  }\n}\n","import { cli } from \"./cli.js\";\nimport process from \"node:process\";\n\nasync function main() {\n  cli.parse(process.argv);\n}\n\nmain();\n"],"mappings":"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","names":["process","process","process","process","process","process"]}

package/package.json

@@ -0,0 +1,84 @@
+{
+  "name": "dynmcp",
+  "version": "0.0.1",
+  "description": "Dynamic MCP context management tool for AI MCP-enabled agents and clients.",
+  "author": "Brandon Burrus <brandon@burrus.io>",
+  "license": "MIT",
+  "type": "module",
+  "homepage": "https://github.com/brandonburrus/dynamic-discovery-mcp#readme",
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "ai",
+    "agent",
+    "proxy",
+    "dynamic",
+    "discovery",
+    "tools",
+    "llm",
+    "cli"
+  ],
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/brandonburrus/dynamic-discovery-mcp.git"
+  },
+  "bugs": {
+    "url": "https://github.com/brandonburrus/dynamic-discovery-mcp/issues"
+  },
+  "main": "./dist/index.cjs",
+  "module": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "dynmcp": "./dist/index.js"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsx src/index.ts",
+    "typecheck": "tsc --noEmit",
+    "lint": "biome lint .",
+    "format": "biome format --write .",
+    "check": "biome check --write .",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "prepare": "husky"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "boxen": "^8.0.1",
+    "chalk": "^5.6.2",
+    "commander": "^14.0.3",
+    "enquirer": "^2.4.1",
+    "fastmcp": "^4.0.1",
+    "figlet": "^1.11.0",
+    "figures": "^6.1.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@biomejs/biome": "^2.4.15",
+    "@commitlint/cli": "^21.0.1",
+    "@commitlint/config-conventional": "^21.0.1",
+    "@types/node": "^25.9.0",
+    "husky": "^9.1.7",
+    "tsup": "^8.5.1",
+    "tsx": "^4.22.2",
+    "typescript": "^6.0.3",
+    "vitest": "^4.1.6"
+  }
+}