forage-mcp 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,18 @@
+# Changelog
+
+All notable changes to this project will be documented in this file.
+
+The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/),
+and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
+
+## [0.1.0] - 2025-02-16
+
+### Added
+
+- MCP server with 6 tools: `forage_search`, `forage_evaluate`, `forage_install`, `forage_learn`, `forage_status`, `forage_uninstall`
+- Registry search across Official MCP Registry, Smithery, and npm
+- Proxy/gateway pattern — installed tools run as child processes with instant availability via `list_changed` notifications
+- Persistence layer at `~/.forage/` with `manifest.json` (auto-start config) and `install-log.json` (audit trail)
+- Agent rule file support — writes to CLAUDE.md, AGENTS.md, and `.cursor/rules/` with clean HTML comment markers
+- CLI with `forage init`, `forage search`, and `forage list` commands
+- Human approval required for all installs (`confirm: true` safety gate)

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Isaac Levine
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,157 @@
+# Forage
+
+**Self-improving tool discovery for AI agents.**
+
+[![npm version](https://img.shields.io/npm/v/forage-mcp.svg)](https://www.npmjs.com/package/forage-mcp)
+[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)
+
+Forage is an MCP server that lets AI agents discover, install, and learn to use new tools — automatically. When an agent hits a wall, it forages for the right tool, installs it, and teaches itself how to use it. The agent gets permanently smarter.
+
+## The Problem
+
+AI coding agents are limited to whatever tools they're configured with at session start. When an agent needs to query a database, deploy to Vercel, or search Slack, it apologizes and the human manually installs the right MCP server. This is the bottleneck of agentic development.
+
+## The Solution
+
+Forage closes the self-improvement loop:
+
+```
+Agent encounters a task it can't do
+  → forage_search("query postgres database")
+  → forage_install("@modelcontextprotocol/server-postgres")
+  → Tools available IMMEDIATELY (no restart)
+  → forage_learn() saves instructions to CLAUDE.md
+  → Next session: auto-starts, agent already knows how to use it
+```
+
+## Quick Start
+
+### Claude Code
+
+```bash
+claude mcp add forage -- npx -y forage-mcp
+```
+
+### Cursor
+
+```bash
+npx forage-mcp init --client cursor
+```
+
+Then start a new session. Forage is ready.
+
+## Tools
+
+| Tool | Description |
+|---|---|
+| `forage_search` | Search for MCP servers across the [Official MCP Registry](https://registry.modelcontextprotocol.io), [Smithery](https://smithery.ai), and [npm](https://www.npmjs.com) |
+| `forage_evaluate` | Get details on a package — downloads, README, install command |
+| `forage_install` | Install and start an MCP server as a proxied subprocess (requires user approval) |
+| `forage_learn` | Write usage instructions to CLAUDE.md / AGENTS.md / .cursor/rules/ |
+| `forage_status` | List all installed and running tools |
+| `forage_uninstall` | Remove a tool and clean up rules |
+
+## How It Works
+
+Forage is an MCP server that acts as a **gateway/proxy**:
+
+1. **You install Forage once** — it's the only MCP server you configure manually
+2. **Forage discovers tools** — searches the Official MCP Registry, Smithery, and npm in parallel
+3. **Forage installs tools** — starts them as child processes, wraps their capabilities
+4. **No restart needed** — Forage emits `list_changed` notifications, agent picks up new tools instantly
+5. **Knowledge persists** — `forage_learn` writes to agent rule files, manifest auto-starts tools next session
+
+### Architecture
+
+```
+┌─────────────────────────────────────────────┐
+│  Claude Code / Cursor / Codex               │
+│                                             │
+│  "I need to query a Postgres database"      │
+└──────────────────┬──────────────────────────┘
+                   │ MCP
+                   ▼
+┌─────────────────────────────────────────────┐
+│  Forage MCP Server                          │
+│                                             │
+│  forage_search ─── Official Registry        │
+│  forage_install    Smithery                 │
+│  forage_learn      npm                      │
+│  forage_status                              │
+│                                             │
+│  ┌─────────────┐  ┌─────────────┐          │
+│  │ Postgres MCP│  │ GitHub MCP  │  ...      │
+│  │ (subprocess)│  │ (subprocess)│          │
+│  └─────────────┘  └─────────────┘          │
+└─────────────────────────────────────────────┘
+```
+
+### The Proxy Pattern
+
+When you install a tool through Forage:
+
+1. Forage runs `npx -y <package>` as a child process
+2. Connects to it via `StdioClientTransport` (MCP client)
+3. Discovers the child server's tools via `listTools`
+4. Re-registers each tool on the Forage server with a namespaced name (`foraged__<server>__<tool>`)
+5. Sends `tools/list_changed` notification — the agent sees new tools immediately
+6. When the agent calls a proxied tool, Forage forwards the call to the child server
+
+## Persistence
+
+Forage stores its state in `~/.forage/`:
+
+| File | Purpose |
+|---|---|
+| `manifest.json` | Installed tools, command/args, auto-start configuration |
+| `install-log.json` | Audit trail of all installs and uninstalls |
+| `cache/` | Cached registry search results |
+
+On startup, Forage reads the manifest and auto-starts all previously installed servers. Your agent picks up right where it left off.
+
+## CLI
+
+Forage also includes a CLI for humans:
+
+```bash
+forage search "postgres database"    # Search registries
+forage list                          # List installed tools
+forage init                          # Set up for Claude Code
+forage init --client cursor          # Set up for Cursor
+```
+
+## Security
+
+- **Human approval required** — `forage_install` always requires explicit `confirm: true`. The agent cannot install tools without the user approving the tool call.
+- **Audit trail** — every install/uninstall is logged with timestamps to `~/.forage/install-log.json`
+- **No remote backend** — everything runs locally. Registry searches are read-only GET requests to public APIs.
+- **No secrets stored** — environment variables for child servers are passed at install time, not persisted.
+
+## Development
+
+```bash
+git clone https://github.com/isaac-levine/forage.git
+cd forage
+npm install
+npm run build
+```
+
+Test locally with Claude Code:
+
+```bash
+claude mcp add forage-dev -- node /path/to/forage/dist/server.js
+```
+
+See [CONTRIBUTING.md](CONTRIBUTING.md) for more details.
+
+## Roadmap
+
+- [ ] `forage update` — check for newer versions of installed tools
+- [ ] Support for pip/cargo/brew packages (not just npm)
+- [ ] Smarter search ranking (weight by downloads, stars, description relevance)
+- [ ] `server.json` submission to the Official MCP Registry
+- [ ] Landing page at forage.dev
+
+## License
+
+[MIT](LICENSE)

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":""}

package/dist/cli.js

@@ -0,0 +1,146 @@
+#!/usr/bin/env node
+import { parseArgs } from "node:util";
+import { exec } from "node:child_process";
+import { promisify } from "node:util";
+import { forage_search } from "./tools/search.js";
+import { listTools } from "./persistence/manifest.js";
+const execAsync = promisify(exec);
+const HELP = `
+forage — Self-improving tool discovery for AI agents
+
+Usage:
+  forage init [--client <name>]    Set up Forage for your AI agent
+  forage search <query>            Search for MCP servers
+  forage list                      List installed tools
+  forage help                      Show this help message
+
+Examples:
+  forage init                      Add Forage to Claude Code
+  forage init --client cursor      Add Forage to Cursor
+  forage search "postgres database"
+  forage list
+`.trim();
+async function main() {
+    const args = process.argv.slice(2);
+    if (args.length === 0 || args[0] === "help" || args[0] === "--help") {
+        console.log(HELP);
+        return;
+    }
+    const command = args[0];
+    switch (command) {
+        case "init":
+            await handleInit(args.slice(1));
+            break;
+        case "search":
+            await handleSearch(args.slice(1));
+            break;
+        case "list":
+            await handleList();
+            break;
+        default:
+            console.error(`Unknown command: ${command}`);
+            console.log(HELP);
+            process.exit(1);
+    }
+}
+async function handleInit(args) {
+    const { values } = parseArgs({
+        args,
+        options: {
+            client: { type: "string", default: "claude-code" },
+        },
+        allowPositionals: false,
+    });
+    const client = values.client ?? "claude-code";
+    switch (client) {
+        case "claude-code": {
+            console.log("Adding Forage to Claude Code...");
+            try {
+                await execAsync("claude mcp add forage -- npx -y forage-mcp");
+                console.log("Done! Forage has been added to Claude Code.");
+                console.log("Start a new Claude Code session to use it.");
+            }
+            catch {
+                console.log("Could not run `claude mcp add` automatically.");
+                console.log("Run this command manually:");
+                console.log("");
+                console.log("  claude mcp add forage -- npx -y forage-mcp");
+            }
+            break;
+        }
+        case "cursor": {
+            console.log("Adding Forage to Cursor...");
+            const fs = await import("node:fs/promises");
+            const path = await import("node:path");
+            const mcpConfigPath = path.join(process.cwd(), ".cursor", "mcp.json");
+            let config = {};
+            try {
+                const existing = await fs.readFile(mcpConfigPath, "utf-8");
+                config = JSON.parse(existing);
+            }
+            catch {
+                // No existing config
+            }
+            const mcpServers = config.mcpServers ?? {};
+            mcpServers.forage = {
+                command: "npx",
+                args: ["-y", "forage-mcp"],
+            };
+            config.mcpServers = mcpServers;
+            await fs.mkdir(path.dirname(mcpConfigPath), { recursive: true });
+            await fs.writeFile(mcpConfigPath, JSON.stringify(config, null, 2), "utf-8");
+            console.log(`Written to ${mcpConfigPath}`);
+            console.log("Restart Cursor to use Forage.");
+            break;
+        }
+        default:
+            console.error(`Unsupported client: ${client}`);
+            console.log("Supported clients: claude-code, cursor");
+            process.exit(1);
+    }
+}
+async function handleSearch(args) {
+    const query = args.join(" ");
+    if (!query) {
+        console.error("Usage: forage search <query>");
+        process.exit(1);
+    }
+    console.log(`Searching for "${query}"...\n`);
+    const { results } = await forage_search({ query });
+    if (results.length === 0) {
+        console.log("No results found.");
+        return;
+    }
+    for (const result of results) {
+        const badge = result.source === "official-registry"
+            ? "[official]"
+            : result.source === "smithery"
+                ? "[smithery]"
+                : "[npm]";
+        console.log(`  ${badge} ${result.packageName}`);
+        console.log(`    ${result.description}`);
+        if (result.url)
+            console.log(`    ${result.url}`);
+        console.log("");
+    }
+}
+async function handleList() {
+    const tools = await listTools();
+    if (tools.length === 0) {
+        console.log("No tools installed via Forage.");
+        return;
+    }
+    console.log("Installed tools:\n");
+    for (const tool of tools) {
+        console.log(`  ${tool.name}`);
+        console.log(`    Package: ${tool.packageName}`);
+        console.log(`    Installed: ${tool.installedAt}`);
+        console.log(`    Auto-start: ${tool.autoStart}`);
+        console.log("");
+    }
+}
+main().catch((error) => {
+    console.error(error);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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"}

package/dist/persistence/log.d.ts

@@ -0,0 +1,11 @@
+export interface LogEntry {
+    timestamp: string;
+    action: "install" | "uninstall";
+    packageName: string;
+    version?: string;
+    source?: string;
+    success: boolean;
+    error?: string;
+}
+export declare function appendLog(entry: LogEntry): Promise<void>;
+//# sourceMappingURL=log.d.ts.map

package/dist/persistence/log.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.d.ts","sourceRoot":"","sources":["../../src/persistence/log.ts"],"names":[],"mappings":"AAKA,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,SAAS,GAAG,WAAW,CAAC;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAaD,wBAAsB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAK9D"}

package/dist/persistence/log.js

@@ -0,0 +1,21 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+import { ensureForageDir } from "./manifest.js";
+const LOG_PATH = path.join(os.homedir(), ".forage", "install-log.json");
+async function readLog() {
+    try {
+        const data = await fs.readFile(LOG_PATH, "utf-8");
+        return JSON.parse(data);
+    }
+    catch {
+        return [];
+    }
+}
+export async function appendLog(entry) {
+    await ensureForageDir();
+    const log = await readLog();
+    log.push(entry);
+    await fs.writeFile(LOG_PATH, JSON.stringify(log, null, 2), "utf-8");
+}
+//# sourceMappingURL=log.js.map

package/dist/persistence/log.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"log.js","sourceRoot":"","sources":["../../src/persistence/log.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAYhD,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,EAAE,kBAAkB,CAAC,CAAC;AAExE,KAAK,UAAU,OAAO;IACpB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;QAClD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAe,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAe;IAC7C,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,GAAG,GAAG,MAAM,OAAO,EAAE,CAAC;IAC5B,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAChB,MAAM,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AACtE,CAAC"}

package/dist/persistence/manifest.d.ts

@@ -0,0 +1,24 @@
+export interface InstalledTool {
+    name: string;
+    packageName: string;
+    version: string;
+    source: "npm" | "official-registry" | "smithery";
+    command: string;
+    args: string[];
+    env?: Record<string, string>;
+    autoStart: boolean;
+    installedAt: string;
+    rules?: string;
+}
+export interface Manifest {
+    version: 1;
+    tools: Record<string, InstalledTool>;
+}
+export declare function ensureForageDir(): Promise<void>;
+export declare function readManifest(): Promise<Manifest>;
+export declare function writeManifest(manifest: Manifest): Promise<void>;
+export declare function addTool(tool: InstalledTool): Promise<void>;
+export declare function removeTool(name: string): Promise<InstalledTool | null>;
+export declare function getTool(name: string): Promise<InstalledTool | null>;
+export declare function listTools(): Promise<InstalledTool[]>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/persistence/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/persistence/manifest.ts"],"names":[],"mappings":"AAIA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,KAAK,GAAG,mBAAmB,GAAG,UAAU,CAAC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC7B,SAAS,EAAE,OAAO,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,WAAW,QAAQ;IACvB,OAAO,EAAE,CAAC,CAAC;IACX,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,CAAC;CACtC;AAKD,wBAAsB,eAAe,IAAI,OAAO,CAAC,IAAI,CAAC,CAGrD;AAED,wBAAsB,YAAY,IAAI,OAAO,CAAC,QAAQ,CAAC,CAOtD;AAED,wBAAsB,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAGrE;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,CAIhE;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAQ5E;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,GAAG,IAAI,CAAC,CAGzE;AAED,wBAAsB,SAAS,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC,CAG1D"}

package/dist/persistence/manifest.js

@@ -0,0 +1,45 @@
+import fs from "node:fs/promises";
+import path from "node:path";
+import os from "node:os";
+const FORAGE_DIR = path.join(os.homedir(), ".forage");
+const MANIFEST_PATH = path.join(FORAGE_DIR, "manifest.json");
+export async function ensureForageDir() {
+    await fs.mkdir(FORAGE_DIR, { recursive: true });
+    await fs.mkdir(path.join(FORAGE_DIR, "cache"), { recursive: true });
+}
+export async function readManifest() {
+    try {
+        const data = await fs.readFile(MANIFEST_PATH, "utf-8");
+        return JSON.parse(data);
+    }
+    catch {
+        return { version: 1, tools: {} };
+    }
+}
+export async function writeManifest(manifest) {
+    await ensureForageDir();
+    await fs.writeFile(MANIFEST_PATH, JSON.stringify(manifest, null, 2), "utf-8");
+}
+export async function addTool(tool) {
+    const manifest = await readManifest();
+    manifest.tools[tool.name] = tool;
+    await writeManifest(manifest);
+}
+export async function removeTool(name) {
+    const manifest = await readManifest();
+    const tool = manifest.tools[name] ?? null;
+    if (tool) {
+        delete manifest.tools[name];
+        await writeManifest(manifest);
+    }
+    return tool;
+}
+export async function getTool(name) {
+    const manifest = await readManifest();
+    return manifest.tools[name] ?? null;
+}
+export async function listTools() {
+    const manifest = await readManifest();
+    return Object.values(manifest.tools);
+}
+//# sourceMappingURL=manifest.js.map

package/dist/persistence/manifest.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.js","sourceRoot":"","sources":["../../src/persistence/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAClC,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,MAAM,SAAS,CAAC;AAoBzB,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,EAAE,SAAS,CAAC,CAAC;AACtD,MAAM,aAAa,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,eAAe,CAAC,CAAC;AAE7D,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,EAAE,CAAC,KAAK,CAAC,UAAU,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IAChD,MAAM,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,OAAO,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AACtE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,YAAY;IAChC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;QACvD,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAa,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CAAC;IACnC,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,aAAa,CAAC,QAAkB;IACpD,MAAM,eAAe,EAAE,CAAC;IACxB,MAAM,EAAE,CAAC,SAAS,CAAC,aAAa,EAAE,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;AAChF,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAmB;IAC/C,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACjC,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,MAAM,IAAI,GAAG,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;IAC1C,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,aAAa,CAAC,QAAQ,CAAC,CAAC;IAChC,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAY;IACxC,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,OAAO,QAAQ,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC;AACtC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,SAAS;IAC7B,MAAM,QAAQ,GAAG,MAAM,YAAY,EAAE,CAAC;IACtC,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;AACvC,CAAC"}

package/dist/proxy/manager.d.ts

@@ -0,0 +1,20 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import type { InstalledTool } from "../persistence/manifest.js";
+export interface ManagedServer {
+    name: string;
+    client: Client;
+    transport: StdioClientTransport;
+    tools: Array<{
+        name: string;
+        description?: string;
+        inputSchema: Record<string, unknown>;
+    }>;
+}
+export declare function startServer(tool: InstalledTool): Promise<ManagedServer>;
+export declare function stopServer(name: string): Promise<boolean>;
+export declare function callTool(serverName: string, toolName: string, args: Record<string, unknown>): Promise<unknown>;
+export declare function getRunningServers(): Map<string, ManagedServer>;
+export declare function getServer(name: string): ManagedServer | undefined;
+export declare function stopAll(): Promise<void>;
+//# sourceMappingURL=manager.d.ts.map

package/dist/proxy/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../../src/proxy/manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAEhE,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,oBAAoB,CAAC;IAChC,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;KACtC,CAAC,CAAC;CACJ;AAID,wBAAsB,WAAW,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC,CAuC7E;AAED,wBAAsB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAY/D;AAED,wBAAsB,QAAQ,CAC5B,UAAU,EAAE,MAAM,EAClB,QAAQ,EAAE,MAAM,EAChB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC5B,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED,wBAAgB,iBAAiB,IAAI,GAAG,CAAC,MAAM,EAAE,aAAa,CAAC,CAE9D;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,SAAS,CAEjE;AAED,wBAAsB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC,CAG7C"}

package/dist/proxy/manager.js

@@ -0,0 +1,77 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+const servers = new Map();
+export async function startServer(tool) {
+    // If already running, return existing
+    const existing = servers.get(tool.name);
+    if (existing) {
+        return existing;
+    }
+    const transport = new StdioClientTransport({
+        command: tool.command,
+        args: tool.args,
+        env: tool.env
+            ? { ...filterEnv(process.env), ...tool.env }
+            : filterEnv(process.env),
+    });
+    const client = new Client({ name: `forage-proxy-${tool.name}`, version: "0.1.0" }, { capabilities: {} });
+    await client.connect(transport);
+    // Discover the child server's tools
+    const toolsList = await client.listTools();
+    const tools = (toolsList.tools ?? []).map((t) => ({
+        name: t.name,
+        description: t.description,
+        inputSchema: t.inputSchema,
+    }));
+    const managed = {
+        name: tool.name,
+        client,
+        transport,
+        tools,
+    };
+    servers.set(tool.name, managed);
+    return managed;
+}
+export async function stopServer(name) {
+    const server = servers.get(name);
+    if (!server)
+        return false;
+    try {
+        await server.client.close();
+    }
+    catch {
+        // Ignore close errors — transport cleanup handles it
+    }
+    servers.delete(name);
+    return true;
+}
+export async function callTool(serverName, toolName, args) {
+    const server = servers.get(serverName);
+    if (!server) {
+        throw new Error(`Server "${serverName}" is not running`);
+    }
+    const result = await server.client.callTool({
+        name: toolName,
+        arguments: args,
+    });
+    return result;
+}
+export function getRunningServers() {
+    return servers;
+}
+export function getServer(name) {
+    return servers.get(name);
+}
+export async function stopAll() {
+    const names = [...servers.keys()];
+    await Promise.all(names.map((name) => stopServer(name)));
+}
+function filterEnv(env) {
+    const result = {};
+    for (const [key, value] of Object.entries(env)) {
+        if (value !== undefined)
+            result[key] = value;
+    }
+    return result;
+}
+//# sourceMappingURL=manager.js.map

package/dist/proxy/manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.js","sourceRoot":"","sources":["../../src/proxy/manager.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AAcjF,MAAM,OAAO,GAAG,IAAI,GAAG,EAAyB,CAAC;AAEjD,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAmB;IACnD,sCAAsC;IACtC,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACxC,IAAI,QAAQ,EAAE,CAAC;QACb,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED,MAAM,SAAS,GAAG,IAAI,oBAAoB,CAAC;QACzC,OAAO,EAAE,IAAI,CAAC,OAAO;QACrB,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,GAAG,EAAE,IAAI,CAAC,GAAG;YACX,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE;YAC5C,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC;KAC3B,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,IAAI,MAAM,CACvB,EAAE,IAAI,EAAE,gBAAgB,IAAI,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,OAAO,EAAE,EACvD,EAAE,YAAY,EAAE,EAAE,EAAE,CACrB,CAAC;IAEF,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,oCAAoC;IACpC,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,SAAS,EAAE,CAAC;IAC3C,MAAM,KAAK,GAAG,CAAC,SAAS,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAChD,IAAI,EAAE,CAAC,CAAC,IAAI;QACZ,WAAW,EAAE,CAAC,CAAC,WAAW;QAC1B,WAAW,EAAE,CAAC,CAAC,WAAsC;KACtD,CAAC,CAAC,CAAC;IAEJ,MAAM,OAAO,GAAkB;QAC7B,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,MAAM;QACN,SAAS;QACT,KAAK;KACN,CAAC;IAEF,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAChC,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAE1B,IAAI,CAAC;QACH,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;IAC9B,CAAC;IAAC,MAAM,CAAC;QACP,qDAAqD;IACvD,CAAC;IAED,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IACrB,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,QAAQ,CAC5B,UAAkB,EAClB,QAAgB,EAChB,IAA6B;IAE7B,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC;IACvC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,WAAW,UAAU,kBAAkB,CAAC,CAAC;IAC3D,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC1C,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,IAAI;KAChB,CAAC,CAAC;IAEH,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,iBAAiB;IAC/B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,OAAO;IAC3B,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC;IAClC,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC3D,CAAC;AAED,SAAS,SAAS,CAChB,GAAsB;IAEtB,MAAM,MAAM,GAA2B,EAAE,CAAC;IAC1C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,IAAI,KAAK,KAAK,SAAS;YAAE,MAAM,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC;IAC/C,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/proxy/wrapper.d.ts

@@ -0,0 +1,20 @@
+export interface WrappedTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    serverName: string;
+    originalName: string;
+}
+/**
+ * Get all tools from all running proxied servers, namespaced to avoid collisions.
+ * Tool names are prefixed with the server name: "server-postgres__query" -> "foraged__server-postgres__query"
+ */
+export declare function getWrappedTools(): WrappedTool[];
+/**
+ * Parse a wrapped tool name back to server name + original tool name.
+ */
+export declare function parseWrappedToolName(name: string): {
+    serverName: string;
+    toolName: string;
+} | null;
+//# sourceMappingURL=wrapper.d.ts.map

package/dist/proxy/wrapper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"wrapper.d.ts","sourceRoot":"","sources":["../../src/proxy/wrapper.ts"],"names":[],"mappings":"AAGA,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,UAAU,EAAE,MAAM,CAAC;IACnB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,eAAe,IAAI,WAAW,EAAE,CAgB/C;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,GACX;IAAE,UAAU,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAOjD"}

package/dist/proxy/wrapper.js

@@ -0,0 +1,37 @@
+import { getRunningServers } from "./manager.js";
+/**
+ * Get all tools from all running proxied servers, namespaced to avoid collisions.
+ * Tool names are prefixed with the server name: "server-postgres__query" -> "foraged__server-postgres__query"
+ */
+export function getWrappedTools() {
+    const tools = [];
+    for (const [serverName, server] of getRunningServers()) {
+        for (const tool of server.tools) {
+            tools.push({
+                name: `foraged__${sanitizeName(serverName)}__${tool.name}`,
+                description: `[via ${serverName}] ${tool.description ?? ""}`.trim(),
+                inputSchema: tool.inputSchema,
+                serverName,
+                originalName: tool.name,
+            });
+        }
+    }
+    return tools;
+}
+/**
+ * Parse a wrapped tool name back to server name + original tool name.
+ */
+export function parseWrappedToolName(name) {
+    if (!name.startsWith("foraged__"))
+        return null;
+    const parts = name.slice("foraged__".length).split("__");
+    if (parts.length < 2)
+        return null;
+    const serverName = parts[0];
+    const toolName = parts.slice(1).join("__");
+    return { serverName, toolName };
+}
+function sanitizeName(name) {
+    return name.replace(/[^a-zA-Z0-9_-]/g, "_");
+}
+//# sourceMappingURL=wrapper.js.map