mcpico 0.1.0

package/README.md

@@ -0,0 +1,172 @@
+# MCPico
+
+**MCP proxy that bundles flat tool lists into hierarchical subcommand groups.**
+
+MCPico (MCP + "ico" = tiny) wraps upstream MCP servers, grouping their tools into discoverable subcommand-based tools. One tool per group, not one per tool. The `help` subcommand auto-generates rich documentation from upstream schemas.
+
+## The Problem
+
+MCP servers expose tools as a flat list. Every tool costs context tokens. A filesystem server exposes 14+ separate tools — the model sees all of them, all the time, even when it only needs one.
+
+Some clients add "tool search" as a workaround. But searching requires the model to proactively look for tools it doesn't know exist. No structural signal about which tools relate to each other.
+
+## MCPico's Solution
+
+Group related tools under a single entry point. The model sees 9 groups instead of 14 tools. Discovery is built-in via `help`:
+
+```
+→ filesystem tools:
+  14 tools → 9 groups: read, write, edit, create, list, directory, move, search, get
+```
+
+## Features
+
+- **Tool bundling** — Groups tools by prefix (configurable separator), collapsing flat tool lists
+- **Auto-generated help** — Each group's `help` subcommand is built from upstream tool schemas
+- **Multi-server aggregation** — Proxy multiple upstream MCP servers through one interface
+- **Dual transport** — Supports both stdio and Streamable HTTP (SSE) upstream servers
+- **Configurable timeouts** — Per-server connection timeout with sensible default (30s)
+- **Resource & prompt passthrough** — Namespaced to avoid collisions across servers
+
+## Usage
+
+### Install
+
+```bash
+npm install -g mcpico
+```
+
+### Configure
+
+Create `mcpico.json`:
+
+```json
+{
+  "servers": [
+    {
+      "name": "filesystem",
+      "transport": {
+        "type": "stdio",
+        "command": "npx",
+        "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/allowed/dir"]
+      }
+    }
+  ]
+}
+```
+
+### Run
+
+```bash
+mcpico
+```
+
+### Connect your MCP client
+
+Add MCPico as a server in your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "mcpico": {
+      "command": "mcpico",
+      "args": ["--config", "/path/to/mcpico.json"]
+    }
+  }
+}
+```
+
+## How it works
+
+1. **Connect** to upstream MCP servers
+2. **Discover** their tools (`tools/list`)
+3. **Group** tools by prefix (configurable separator, default `_`)
+   - `filesystem_read_file`, `filesystem_write_file` → group `filesystem`
+4. **Register** each group as a single MCP tool with a `command` string argument
+5. **Forward** tool calls by parsing `<subcommand> {"key":"value"}` and proxying to upstream
+6. **Generate help** dynamically from original tool schemas
+
+### Command format
+
+```
+<subcommand> {"arg1":"val1","arg2":"val2"}
+```
+
+Examples:
+- `help` — see all subcommands and their parameters
+- `read_file {"path":"/tmp/hello.txt"}` — call a specific tool
+- `write_file {"path":"/tmp/out.txt","content":"hello"}` — with arguments
+
+### Multi-server aggregation
+
+MCPico can proxy multiple upstream servers simultaneously:
+
+```json
+{
+  "servers": [
+    {
+      "name": "filesystem",
+      "transport": {
+        "type": "stdio",
+        "command": "npx",
+        "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
+      }
+    },
+    {
+      "name": "github",
+      "transport": {
+        "type": "sse",
+        "url": "https://mcp-github.example.com/mcp"
+      }
+    }
+  ]
+}
+```
+
+Groups from different servers are merged if they share a prefix. Otherwise each server's tools appear as separate groups.
+
+## Configuration
+
+| Field | Type | Default | Description |
+|-------|------|---------|-------------|
+| `servers` | `ServerConfig[]` | **required** | Upstream MCP servers to proxy |
+| `separator` | `string` | `"_"` | Separator for prefix-based tool grouping |
+| `groups` | `object` | `{}` | Explicit group overrides (`{ "group": ["tool1","tool2"] }`) |
+
+### ServerConfig
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `name` | `string` | yes | Friendly name / group namespace |
+| `transport` | `TransportConfig` | yes | How to connect to the upstream server |
+| `connectTimeoutMs` | `number` | no | Connection timeout in ms (default: 30000) |
+
+### TransportConfig (stdio)
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `type` | `"stdio"` | yes | Transport type |
+| `command` | `string` | yes | Executable to spawn |
+| `args` | `string[]` | no | Command-line arguments |
+| `env` | `object` | no | Environment variables |
+| `cwd` | `string` | no | Working directory |
+
+### TransportConfig (SSE / Streamable HTTP)
+
+| Field | Type | Required | Description |
+|-------|------|----------|-------------|
+| `type` | `"sse"` | yes | Transport type |
+| `url` | `string` | yes | Full URL to MCP Streamable HTTP endpoint |
+
+## Development
+
+```bash
+npm install
+npm run build    # TypeScript compilation
+npm test         # Run tests (77 tests, vitest)
+npm run dev      # Run directly with tsx
+```
+
+## License
+
+MIT

package/dist/config.d.ts

@@ -0,0 +1,46 @@
+/**
+ * Transport configuration for connecting to an upstream MCP server.
+ */
+export type TransportConfig = {
+    type: "stdio";
+    command: string;
+    args?: string[];
+    env?: Record<string, string>;
+    cwd?: string;
+} | {
+    type: "sse";
+    /** Full URL to the MCP Streamable HTTP endpoint (e.g. "https://mcp.example.com/mcp") */
+    url: string;
+};
+/**
+ * Server configuration entry.
+ */
+export interface ServerConfig {
+    /** Friendly name used as the tool group namespace */
+    name: string;
+    /** Transport to connect to this upstream server */
+    transport: TransportConfig;
+    /** Connection timeout in milliseconds (default: 30000) */
+    connectTimeoutMs?: number;
+}
+/**
+ * Tool grouping override — map group names to explicit tool lists.
+ */
+export interface GroupOverrides {
+    [groupName: string]: string[];
+}
+/**
+ * Full MCPico configuration.
+ */
+export interface MCPicoConfig {
+    /** Upstream MCP servers to proxy */
+    servers: ServerConfig[];
+    /** Separator used for prefix-based tool grouping (default: "_") */
+    separator?: string;
+    /** Explicit group overrides — tools not listed here are auto-grouped */
+    groups?: GroupOverrides;
+}
+/**
+ * Validate server config and return a user-friendly error message, or null if valid.
+ */
+export declare function validateServerConfig(server: ServerConfig): string | null;

package/dist/config.js

@@ -0,0 +1,32 @@
+/**
+ * Validate server config and return a user-friendly error message, or null if valid.
+ */
+export function validateServerConfig(server) {
+    if (!server.name || typeof server.name !== "string") {
+        return 'Each server must have a non-empty "name" (string)';
+    }
+    if (!server.transport) {
+        return `Server "${server.name}": missing "transport"`;
+    }
+    if (server.transport.type === "stdio") {
+        if (!server.transport.command) {
+            return `Server "${server.name}": stdio transport requires "command"`;
+        }
+    }
+    else if (server.transport.type === "sse") {
+        if (!server.transport.url) {
+            return `Server "${server.name}": sse transport requires "url"`;
+        }
+        try {
+            new URL(server.transport.url);
+        }
+        catch {
+            return `Server "${server.name}": sse transport "url" is not a valid URL: "${server.transport.url}"`;
+        }
+    }
+    else {
+        return `Server "${server.name}": unknown transport type "${server.transport.type}". Supported: stdio, sse`;
+    }
+    return null;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAgDA;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,MAAoB;IACvD,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QACpD,OAAO,mDAAmD,CAAC;IAC7D,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;QACtB,OAAO,WAAW,MAAM,CAAC,IAAI,wBAAwB,CAAC;IACxD,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,OAAO,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EAAE,CAAC;YAC9B,OAAO,WAAW,MAAM,CAAC,IAAI,uCAAuC,CAAC;QACvE,CAAC;IACH,CAAC;SAAM,IAAI,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QAC3C,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,EAAE,CAAC;YAC1B,OAAO,WAAW,MAAM,CAAC,IAAI,iCAAiC,CAAC;QACjE,CAAC;QACD,IAAI,CAAC;YACH,IAAI,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC;QAChC,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,WAAW,MAAM,CAAC,IAAI,+CAA+C,MAAM,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;QACtG,CAAC;IACH,CAAC;SAAM,CAAC;QACN,OAAO,WAAW,MAAM,CAAC,IAAI,8BAA+B,MAAM,CAAC,SAAoC,CAAC,IAAI,0BAA0B,CAAC;IACzI,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/config.test.d.ts

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

package/dist/config.test.js

@@ -0,0 +1,87 @@
+import { describe, it, expect } from "vitest";
+import { validateServerConfig } from "./config.js";
+describe("validateServerConfig", () => {
+    describe("server name", () => {
+        it("returns error for missing name", () => {
+            const server = { name: "", transport: { type: "stdio", command: "echo" } };
+            expect(validateServerConfig(server)).toContain('"name"');
+        });
+        it("returns null for valid stdio config", () => {
+            const server = {
+                name: "test-server",
+                transport: { type: "stdio", command: "echo" },
+            };
+            expect(validateServerConfig(server)).toBeNull();
+        });
+    });
+    describe("stdio transport", () => {
+        it("requires command", () => {
+            const server = {
+                name: "test",
+                transport: { type: "stdio", command: "" },
+            };
+            expect(validateServerConfig(server)).toContain('"command"');
+        });
+        it("accepts stdio with optional fields", () => {
+            const server = {
+                name: "test",
+                transport: {
+                    type: "stdio",
+                    command: "npx",
+                    args: ["-y", "server"],
+                    env: { DEBUG: "1" },
+                    cwd: "/tmp",
+                },
+            };
+            expect(validateServerConfig(server)).toBeNull();
+        });
+    });
+    describe("sse transport", () => {
+        it("requires url", () => {
+            const server = {
+                name: "test",
+                transport: { type: "sse", url: "" },
+            };
+            expect(validateServerConfig(server)).toContain('"url"');
+        });
+        it("validates URL format", () => {
+            const server = {
+                name: "test",
+                transport: { type: "sse", url: "not-a-valid-url" },
+            };
+            expect(validateServerConfig(server)).toContain("not a valid URL");
+        });
+        it("accepts valid HTTP URL", () => {
+            const server = {
+                name: "test",
+                transport: { type: "sse", url: "http://localhost:8080/mcp" },
+            };
+            expect(validateServerConfig(server)).toBeNull();
+        });
+        it("accepts valid HTTPS URL", () => {
+            const server = {
+                name: "test",
+                transport: { type: "sse", url: "https://mcp.example.com/api" },
+            };
+            expect(validateServerConfig(server)).toBeNull();
+        });
+    });
+    describe("unknown transport", () => {
+        it("returns error for unknown transport type", () => {
+            const server = {
+                name: "test",
+                transport: { type: "websocket" },
+            };
+            const err = validateServerConfig(server);
+            expect(err).toContain("unknown transport type");
+            expect(err).toContain("websocket");
+        });
+    });
+    describe("missing transport", () => {
+        it("returns error for missing transport", () => {
+            const server = { name: "test" };
+            expect(validateServerConfig(server)).toContain('"transport"');
+        });
+    });
+});
+//# sourceMappingURL=config.test.js.map

package/dist/config.test.js.map

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

package/dist/discoverer.d.ts

@@ -0,0 +1,52 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import type { TransportConfig } from "./config.js";
+/**
+ * Tool metadata from an upstream MCP server.
+ */
+export interface UpstreamTool {
+    name: string;
+    description?: string;
+    inputSchema: Record<string, unknown>;
+}
+/**
+ * Resource metadata from an upstream MCP server.
+ */
+export interface UpstreamResource {
+    uri: string;
+    name: string;
+    description?: string;
+    mimeType?: string;
+}
+/**
+ * Prompt metadata from an upstream MCP server.
+ */
+export interface UpstreamPrompt {
+    name: string;
+    description?: string;
+    arguments?: Array<{
+        name: string;
+        description?: string;
+        required?: boolean;
+    }>;
+}
+/**
+ * Discovered upstream server with its tools, resources, and prompts.
+ */
+export interface DiscoveredServer {
+    name: string;
+    tools: UpstreamTool[];
+    resources: UpstreamResource[];
+    prompts: UpstreamPrompt[];
+    client: Client;
+}
+/**
+ * Connect to an upstream MCP server and discover its tools.
+ *
+ * Supports stdio and streamable HTTP transports.
+ * Default connection timeout is 30 seconds.
+ */
+export declare function discoverServer(name: string, transportConfig: TransportConfig, connectTimeoutMs?: number): Promise<DiscoveredServer>;
+/**
+ * Disconnect from an upstream server.
+ */
+export declare function disconnectServer(server: DiscoveredServer): Promise<void>;

package/dist/discoverer.js

@@ -0,0 +1,84 @@
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
+import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js";
+/**
+ * Connect to an upstream MCP server and discover its tools.
+ *
+ * Supports stdio and streamable HTTP transports.
+ * Default connection timeout is 30 seconds.
+ */
+export async function discoverServer(name, transportConfig, connectTimeoutMs = 30_000) {
+    let transport;
+    if (transportConfig.type === "stdio") {
+        transport = new StdioClientTransport({
+            command: transportConfig.command,
+            args: transportConfig.args,
+            env: transportConfig.env,
+            cwd: transportConfig.cwd,
+        });
+    }
+    else if (transportConfig.type === "sse") {
+        transport = new StreamableHTTPClientTransport(new URL(transportConfig.url));
+    }
+    else {
+        throw new Error(`Unsupported transport type: ${transportConfig.type}`);
+    }
+    const client = new Client({ name: `MCPico-${name}`, version: "0.1.0" }, { capabilities: {} });
+    // Connect with timeout
+    await withTimeout(client.connect(transport), connectTimeoutMs, `Connection to "${name}" timed out after ${connectTimeoutMs}ms`);
+    // Discover tools
+    const toolsResult = await client.listTools();
+    const tools = (toolsResult.tools || []).map((t) => ({
+        name: t.name,
+        description: t.description,
+        inputSchema: t.inputSchema || {},
+    }));
+    // Discover resources (if supported)
+    let resources = [];
+    try {
+        const resResult = await client.listResources();
+        resources = (resResult.resources || []).map((r) => ({
+            uri: r.uri,
+            name: r.name,
+            description: r.description,
+            mimeType: r.mimeType,
+        }));
+    }
+    catch {
+        // Resources may not be supported by this server
+    }
+    // Discover prompts (if supported)
+    let prompts = [];
+    try {
+        const promptResult = await client.listPrompts();
+        prompts = (promptResult.prompts || []).map((p) => ({
+            name: p.name,
+            description: p.description,
+            arguments: (p.arguments || []).map((a) => ({
+                name: a.name,
+                description: a.description,
+                required: a.required,
+            })),
+        }));
+    }
+    catch {
+        // Prompts may not be supported by this server
+    }
+    return { name, tools, resources, prompts, client };
+}
+/**
+ * Disconnect from an upstream server.
+ */
+export async function disconnectServer(server) {
+    await server.client.close();
+}
+/**
+ * Race a promise against a timeout.
+ */
+async function withTimeout(promise, timeoutMs, errorMessage) {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => setTimeout(() => reject(new Error(errorMessage)), timeoutMs)),
+    ]);
+}
+//# sourceMappingURL=discoverer.js.map

package/dist/discoverer.js.map

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

package/dist/discoverer.test.d.ts

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

package/dist/discoverer.test.js

@@ -0,0 +1,178 @@
+import { describe, it, expect, vi, beforeEach } from "vitest";
+// Create mock instances for the Client class
+const mockConnect = vi.fn();
+const mockClose = vi.fn();
+let listToolsResult = { tools: [] };
+let listResourcesRejects = true;
+let listResourcesResult = { resources: [] };
+let listPromptsRejects = true;
+let listPromptsResult = { prompts: [] };
+// Mock the MCP SDK modules
+vi.mock("@modelcontextprotocol/sdk/client/index.js", () => ({
+    Client: class {
+        connect = mockConnect;
+        close = mockClose;
+        listTools = () => Promise.resolve(listToolsResult);
+        listResources = () => listResourcesRejects
+            ? Promise.reject(new Error("Not supported"))
+            : Promise.resolve(listResourcesResult);
+        listPrompts = () => listPromptsRejects
+            ? Promise.reject(new Error("Not supported"))
+            : Promise.resolve(listPromptsResult);
+        callTool = vi.fn().mockResolvedValue({
+            content: [{ type: "text", text: "result" }],
+        });
+        readResource = vi.fn().mockResolvedValue({ contents: [] });
+        getPrompt = vi.fn().mockResolvedValue({ messages: [] });
+    },
+}));
+vi.mock("@modelcontextprotocol/sdk/client/stdio.js", () => ({
+    StdioClientTransport: class {
+        constructor(..._args) { }
+    },
+}));
+vi.mock("@modelcontextprotocol/sdk/client/streamableHttp.js", () => ({
+    StreamableHTTPClientTransport: class {
+        constructor(..._args) { }
+    },
+}));
+import { discoverServer, disconnectServer, } from "./discoverer.js";
+describe("discoverServer", () => {
+    const stdioTransport = {
+        type: "stdio",
+        command: "npx",
+        args: ["-y", "test-server"],
+    };
+    beforeEach(() => {
+        vi.clearAllMocks();
+        listToolsResult = { tools: [] };
+        listResourcesRejects = true;
+        listResourcesResult = { resources: [] };
+        listPromptsRejects = true;
+        listPromptsResult = { prompts: [] };
+    });
+    it("connects to upstream and discovers tools", async () => {
+        listToolsResult = {
+            tools: [
+                {
+                    name: "read_file",
+                    description: "Read a file",
+                    inputSchema: { type: "object" },
+                },
+                {
+                    name: "write_file",
+                    description: "Write a file",
+                    inputSchema: { type: "object" },
+                },
+            ],
+        };
+        const server = await discoverServer("test-server", stdioTransport);
+        expect(server.name).toBe("test-server");
+        expect(server.tools).toHaveLength(2);
+        expect(server.tools[0].name).toBe("read_file");
+        expect(server.tools[0].description).toBe("Read a file");
+        expect(server.tools[0].inputSchema).toEqual({ type: "object" });
+        expect(mockConnect).toHaveBeenCalled();
+    });
+    it("handles tools without descriptions or schemas", async () => {
+        listToolsResult = {
+            tools: [{ name: "simple_tool" }],
+        };
+        const server = await discoverServer("test-server", stdioTransport);
+        expect(server.tools).toHaveLength(1);
+        expect(server.tools[0].name).toBe("simple_tool");
+        expect(server.tools[0].inputSchema).toEqual({});
+    });
+    it("discovers resources when supported", async () => {
+        listToolsResult = { tools: [] };
+        listResourcesRejects = false;
+        listResourcesResult = {
+            resources: [
+                {
+                    uri: "file:///tmp/test.txt",
+                    name: "test.txt",
+                    description: "A test file",
+                    mimeType: "text/plain",
+                },
+            ],
+        };
+        const server = await discoverServer("test-server", stdioTransport);
+        expect(server.resources).toHaveLength(1);
+        expect(server.resources[0].uri).toBe("file:///tmp/test.txt");
+        expect(server.resources[0].name).toBe("test.txt");
+        expect(server.resources[0].mimeType).toBe("text/plain");
+    });
+    it("discovers prompts when supported", async () => {
+        listToolsResult = { tools: [] };
+        listPromptsRejects = false;
+        listPromptsResult = {
+            prompts: [
+                {
+                    name: "greeting",
+                    description: "Generate a greeting",
+                    arguments: [
+                        { name: "name", description: "Who to greet", required: true },
+                    ],
+                },
+            ],
+        };
+        const server = await discoverServer("test-server", stdioTransport);
+        expect(server.prompts).toHaveLength(1);
+        expect(server.prompts[0].name).toBe("greeting");
+        expect(server.prompts[0].arguments).toHaveLength(1);
+        expect(server.prompts[0].arguments[0].name).toBe("name");
+        expect(server.prompts[0].arguments[0].required).toBe(true);
+    });
+    it("returns empty arrays when resources/prompts are not supported", async () => {
+        listToolsResult = { tools: [] };
+        listResourcesRejects = true;
+        listPromptsRejects = true;
+        const server = await discoverServer("test-server", stdioTransport);
+        expect(server.resources).toEqual([]);
+        expect(server.prompts).toEqual([]);
+    });
+    it("handles empty tools response gracefully", async () => {
+        listToolsResult = {};
+        const server = await discoverServer("test-server", stdioTransport);
+        expect(server.tools).toEqual([]);
+    });
+    describe("sse transport", () => {
+        const sseTransport = {
+            type: "sse",
+            url: "https://mcp.example.com/api",
+        };
+        it("connects via SSE transport", async () => {
+            listToolsResult = {
+                tools: [{ name: "remote_tool", description: "Remote tool", inputSchema: {} }],
+            };
+            const server = await discoverServer("sse-server", sseTransport);
+            expect(server.name).toBe("sse-server");
+            expect(server.tools).toHaveLength(1);
+            expect(server.tools[0].name).toBe("remote_tool");
+            expect(mockConnect).toHaveBeenCalled();
+        });
+    });
+    describe("timeout", () => {
+        it("rejects after timeout when connection hangs", async () => {
+            // Simulate a connection that never resolves
+            mockConnect.mockImplementationOnce(() => new Promise(() => { }));
+            await expect(discoverServer("slow-server", stdioTransport, 100)).rejects.toThrow("timed out");
+        });
+        it("succeeds when connection is fast enough", async () => {
+            listToolsResult = { tools: [{ name: "fast", inputSchema: {} }] };
+            const server = await discoverServer("fast-server", stdioTransport, 5000);
+            expect(server.tools).toHaveLength(1);
+        });
+    });
+});
+describe("disconnectServer", () => {
+    it("calls client.close()", async () => {
+        const close = vi.fn().mockResolvedValue(undefined);
+        const server = {
+            client: { close },
+        };
+        await disconnectServer(server);
+        expect(close).toHaveBeenCalled();
+    });
+});
+//# sourceMappingURL=discoverer.test.js.map