mcpico 0.1.0

package/dist/index.js

@@ -0,0 +1,90 @@
+#!/usr/bin/env node
+/**
+ * MCPico — MCP proxy that bundles flat tool lists into hierarchical subcommand groups.
+ *
+ * Usage:
+ *   mcpico [--config <path>]
+ *
+ * Configuration is read from mcpico.json in the current directory by default.
+ */
+import { readFileSync } from "node:fs";
+import { resolve } from "node:path";
+import { startServer } from "./server.js";
+async function main() {
+    // Parse CLI args
+    const args = process.argv.slice(2);
+    let configPath = "mcpico.json";
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === "--config" || args[i] === "-c") {
+            configPath = args[i + 1] || configPath;
+            i++;
+        }
+        else if (args[i] === "--version" || args[i] === "-v") {
+            console.log("MCPico v0.1.0");
+            process.exit(0);
+        }
+        else if (args[i] === "--help" || args[i] === "-h") {
+            console.log(`
+MCPico — MCP proxy that bundles flat tool lists into hierarchical subcommand groups.
+
+Usage:
+  mcpico [--config <path>]
+
+Options:
+  --config, -c <path>    Path to config file (default: mcpico.json)
+  --version, -v          Show version
+  --help, -h             Show this help
+
+Config file format (mcpico.json):
+  {
+    "servers": [
+      {
+        "name": "filesystem",
+        "transport": {
+          "type": "stdio",
+          "command": "npx",
+          "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
+        }
+      }
+    ],
+    "separator": "_",
+    "groups": {}
+  }
+`);
+            process.exit(0);
+        }
+    }
+    // Resolve config path
+    const resolvedPath = resolve(configPath);
+    let config;
+    try {
+        const raw = readFileSync(resolvedPath, "utf-8");
+        config = JSON.parse(raw);
+    }
+    catch (err) {
+        console.error(`Error reading config file "${resolvedPath}":`, err.message);
+        process.exit(1);
+    }
+    // Validate
+    if (!config.servers || !Array.isArray(config.servers) || config.servers.length === 0) {
+        console.error('Config error: "servers" must be a non-empty array');
+        process.exit(1);
+    }
+    for (const server of config.servers) {
+        if (!server.name || !server.transport) {
+            console.error('Config error: each server must have a "name" and "transport"');
+            process.exit(1);
+        }
+        if (server.transport.type === "stdio" &&
+            !server.transport.command) {
+            console.error(`Config error: server "${server.name}" missing transport.command`);
+            process.exit(1);
+        }
+    }
+    await startServer(config);
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAG1C,KAAK,UAAU,IAAI;IACjB,iBAAiB;IACjB,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACnC,IAAI,UAAU,GAAG,aAAa,CAAC;IAE/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YAC/C,UAAU,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,UAAU,CAAC;YACvC,CAAC,EAAE,CAAC;QACN,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACvD,OAAO,CAAC,GAAG,CAAC,eAAe,CAAC,CAAC;YAC7B,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;aAAM,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;YACpD,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;CA0BjB,CAAC,CAAC;YACG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,sBAAsB;IACtB,MAAM,YAAY,GAAG,OAAO,CAAC,UAAU,CAAC,CAAC;IACzC,IAAI,MAAoB,CAAC;IAEzB,IAAI,CAAC;QACH,MAAM,GAAG,GAAG,YAAY,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;QAChD,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAiB,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CACX,8BAA8B,YAAY,IAAI,EAC7C,GAAa,CAAC,OAAO,CACvB,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,WAAW;IACX,IAAI,CAAC,MAAM,CAAC,OAAO,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrF,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACpC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,SAAS,EAAE,CAAC;YACtC,OAAO,CAAC,KAAK,CACX,8DAA8D,CAC/D,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,IACE,MAAM,CAAC,SAAS,CAAC,IAAI,KAAK,OAAO;YACjC,CAAC,MAAM,CAAC,SAAS,CAAC,OAAO,EACzB,CAAC;YACD,OAAO,CAAC,KAAK,CACX,yBAAyB,MAAM,CAAC,IAAI,6BAA6B,CAClE,CAAC;YACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;IAED,MAAM,WAAW,CAAC,MAAM,CAAC,CAAC;AAC5B,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/parser.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Result of parsing a command string.
+ */
+export interface ParsedCommand {
+    /** The subcommand name (maps to an upstream tool name) */
+    subcommand: string | null;
+    /** Parsed arguments to pass to the upstream tool */
+    args: Record<string, unknown>;
+    /** Whether this is a help request */
+    isHelp: boolean;
+    /** Error message if parsing failed */
+    error: string | null;
+}
+/**
+ * Parse a command string from the model.
+ *
+ * Format: `<subcommand> <json_args>`
+ *
+ * - Empty string or "help" → isHelp = true
+ * - "read_file" → subcommand = "read_file", args = {}
+ * - 'read_file {"path":"/etc/hosts"}' → subcommand = "read_file", args = {path: "/etc/hosts"}
+ * - "list_dir" → subcommand = "list_dir", args = {}
+ *
+ * Error handling:
+ * - If JSON is malformed, returns error message
+ * - If no subcommand given, returns isHelp = true
+ */
+export declare function parseCommand(rawCommand: string): ParsedCommand;

package/dist/parser.js

@@ -0,0 +1,60 @@
+/**
+ * Parse a command string from the model.
+ *
+ * Format: `<subcommand> <json_args>`
+ *
+ * - Empty string or "help" → isHelp = true
+ * - "read_file" → subcommand = "read_file", args = {}
+ * - 'read_file {"path":"/etc/hosts"}' → subcommand = "read_file", args = {path: "/etc/hosts"}
+ * - "list_dir" → subcommand = "list_dir", args = {}
+ *
+ * Error handling:
+ * - If JSON is malformed, returns error message
+ * - If no subcommand given, returns isHelp = true
+ */
+export function parseCommand(rawCommand) {
+    const trimmed = rawCommand.trim();
+    // Empty or explicit help
+    if (!trimmed || trimmed === "help") {
+        return { subcommand: null, args: {}, isHelp: true, error: null };
+    }
+    // Find the first space to split subcommand from args
+    const spaceIdx = trimmed.indexOf(" ");
+    if (spaceIdx === -1) {
+        // No args — just a subcommand
+        return {
+            subcommand: trimmed,
+            args: {},
+            isHelp: trimmed === "help",
+            error: null,
+        };
+    }
+    const subcommand = trimmed.slice(0, spaceIdx).trim();
+    const argsStr = trimmed.slice(spaceIdx + 1).trim();
+    // Empty args after subcommand
+    if (!argsStr) {
+        return { subcommand, args: {}, isHelp: false, error: null };
+    }
+    // Try JSON parse
+    try {
+        const args = JSON.parse(argsStr);
+        if (typeof args !== "object" || Array.isArray(args)) {
+            return {
+                subcommand,
+                args: {},
+                isHelp: false,
+                error: "Arguments must be a JSON object, e.g. {\"key\":\"value\"}",
+            };
+        }
+        return { subcommand, args: args, isHelp: false, error: null };
+    }
+    catch {
+        return {
+            subcommand,
+            args: {},
+            isHelp: false,
+            error: `Could not parse arguments as JSON: "${argsStr}". Use format: <subcommand> {"key":"value",...}`,
+        };
+    }
+}
+//# sourceMappingURL=parser.js.map

package/dist/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../src/parser.ts"],"names":[],"mappings":"AAcA;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,MAAM,OAAO,GAAG,UAAU,CAAC,IAAI,EAAE,CAAC;IAElC,yBAAyB;IACzB,IAAI,CAAC,OAAO,IAAI,OAAO,KAAK,MAAM,EAAE,CAAC;QACnC,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IACnE,CAAC;IAED,qDAAqD;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAEtC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,8BAA8B;QAC9B,OAAO;YACL,UAAU,EAAE,OAAO;YACnB,IAAI,EAAE,EAAE;YACR,MAAM,EAAE,OAAO,KAAK,MAAM;YAC1B,KAAK,EAAE,IAAI;SACZ,CAAC;IACJ,CAAC;IAED,MAAM,UAAU,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC,IAAI,EAAE,CAAC;IACrD,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC;IAEnD,8BAA8B;IAC9B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC9D,CAAC;IAED,iBAAiB;IACjB,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;QACjC,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;YACpD,OAAO;gBACL,UAAU;gBACV,IAAI,EAAE,EAAE;gBACR,MAAM,EAAE,KAAK;gBACb,KAAK,EAAE,2DAA2D;aACnE,CAAC;QACJ,CAAC;QACD,OAAO,EAAE,UAAU,EAAE,IAAI,EAAE,IAA+B,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC3F,CAAC;IAAC,MAAM,CAAC;QACP,OAAO;YACL,UAAU;YACV,IAAI,EAAE,EAAE;YACR,MAAM,EAAE,KAAK;YACb,KAAK,EAAE,uCAAuC,OAAO,iDAAiD;SACvG,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/parser.test.d.ts

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

package/dist/parser.test.js

@@ -0,0 +1,142 @@
+import { describe, it, expect } from "vitest";
+import { parseCommand } from "./parser.js";
+describe("parseCommand", () => {
+    describe("help / empty", () => {
+        it("returns isHelp for empty string", () => {
+            const result = parseCommand("");
+            expect(result.isHelp).toBe(true);
+            expect(result.subcommand).toBeNull();
+            expect(result.args).toEqual({});
+            expect(result.error).toBeNull();
+        });
+        it("returns isHelp for whitespace-only string", () => {
+            const result = parseCommand("   ");
+            expect(result.isHelp).toBe(true);
+            expect(result.error).toBeNull();
+        });
+        it("returns isHelp for explicit 'help'", () => {
+            const result = parseCommand("help");
+            expect(result.isHelp).toBe(true);
+            expect(result.subcommand).toBeNull();
+            expect(result.args).toEqual({});
+            expect(result.error).toBeNull();
+        });
+        it("returns isHelp for 'help' with extra whitespace", () => {
+            const result = parseCommand("  help  ");
+            expect(result.isHelp).toBe(true);
+            expect(result.args).toEqual({});
+        });
+    });
+    describe("bare subcommand (no args)", () => {
+        it("parses a single-word subcommand", () => {
+            const result = parseCommand("read_file");
+            expect(result.subcommand).toBe("read_file");
+            expect(result.args).toEqual({});
+            expect(result.isHelp).toBe(false);
+            expect(result.error).toBeNull();
+        });
+        it("handles subcommand with trailing whitespace", () => {
+            const result = parseCommand("list_dir  ");
+            expect(result.subcommand).toBe("list_dir");
+            expect(result.args).toEqual({});
+        });
+    });
+    describe("JSON args", () => {
+        it("parses simple JSON object args", () => {
+            const result = parseCommand('read_file {"path":"/etc/hosts"}');
+            expect(result.subcommand).toBe("read_file");
+            expect(result.args).toEqual({ path: "/etc/hosts" });
+            expect(result.error).toBeNull();
+        });
+        it("parses multiple JSON args", () => {
+            const result = parseCommand('write_file {"path":"/tmp/out.txt","content":"hello","encoding":"utf-8"}');
+            expect(result.subcommand).toBe("write_file");
+            expect(result.args).toEqual({
+                path: "/tmp/out.txt",
+                content: "hello",
+                encoding: "utf-8",
+            });
+        });
+        it("parses numeric and boolean values", () => {
+            const result = parseCommand('something {"count":42,"enabled":true,"ratio":3.14}');
+            expect(result.args).toEqual({
+                count: 42,
+                enabled: true,
+                ratio: 3.14,
+            });
+        });
+        it("parses nested JSON objects", () => {
+            const result = parseCommand('complex {"nested":{"key":"value"},"list":[1,2,3]}');
+            expect(result.args).toEqual({
+                nested: { key: "value" },
+                list: [1, 2, 3],
+            });
+        });
+        it("parses null values", () => {
+            const result = parseCommand('cmd {"key":null}');
+            expect(result.args).toEqual({ key: null });
+        });
+    });
+    describe("error handling", () => {
+        it("returns error for malformed JSON", () => {
+            const result = parseCommand('read_file {bad json}');
+            expect(result.error).toContain("Could not parse arguments as JSON");
+            expect(result.args).toEqual({});
+            expect(result.isHelp).toBe(false);
+        });
+        it("returns error for JSON array instead of object", () => {
+            const result = parseCommand('read_file ["a","b"]');
+            expect(result.error).toContain("Arguments must be a JSON object");
+            expect(result.args).toEqual({});
+        });
+        it("returns error for bare JSON primitive", () => {
+            const result = parseCommand('read_file "just a string"');
+            expect(result.error).toContain("Arguments must be a JSON object");
+        });
+        it("returns error for bare JSON number", () => {
+            const result = parseCommand("read_file 42");
+            expect(result.error).toContain("Arguments must be a JSON object");
+        });
+        it("returns error for incomplete JSON", () => {
+            const result = parseCommand('read_file {"path":"/tmp');
+            expect(result.error).toContain("Could not parse arguments as JSON");
+        });
+    });
+    describe("edge cases", () => {
+        it("handles subcommand with spaces in name (unusual but valid)", () => {
+            // First space splits subcommand from args
+            const result = parseCommand('my tool {"a":1}');
+            expect(result.subcommand).toBe("my");
+            expect(result.args).toEqual({});
+            expect(result.error).toContain("Could not parse arguments");
+        });
+        it("handles subcommand followed by empty args", () => {
+            const result = parseCommand("read_file ");
+            expect(result.subcommand).toBe("read_file");
+            expect(result.args).toEqual({});
+            expect(result.error).toBeNull();
+        });
+        it("handles subcommand followed by spaces", () => {
+            const result = parseCommand("read_file   ");
+            expect(result.subcommand).toBe("read_file");
+            expect(result.args).toEqual({});
+        });
+        it("handles JSON with leading/trailing whitespace in args", () => {
+            const result = parseCommand('read_file   {"path":"/tmp"}   ');
+            expect(result.subcommand).toBe("read_file");
+            expect(result.args).toEqual({ path: "/tmp" });
+        });
+        it("handles empty JSON object", () => {
+            const result = parseCommand("cmd {}");
+            expect(result.subcommand).toBe("cmd");
+            expect(result.args).toEqual({});
+            expect(result.error).toBeNull();
+        });
+        it("handles subcommand containing underscores", () => {
+            const result = parseCommand('filesystem_read_file {"path":"/tmp"}');
+            expect(result.subcommand).toBe("filesystem_read_file");
+            expect(result.args).toEqual({ path: "/tmp" });
+        });
+    });
+});
+//# sourceMappingURL=parser.test.js.map

package/dist/parser.test.js.map

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

package/dist/proxy.d.ts

@@ -0,0 +1,6 @@
+import type { CallToolResult } from "@modelcontextprotocol/sdk/types.js";
+import type { DiscoveredServer } from "./discoverer.js";
+/**
+ * Forward a tool call to an upstream MCP server and return the result.
+ */
+export declare function forwardToolCall(server: DiscoveredServer, toolName: string, args: Record<string, unknown>): Promise<CallToolResult>;

package/dist/proxy.js

@@ -0,0 +1,10 @@
+/**
+ * Forward a tool call to an upstream MCP server and return the result.
+ */
+export async function forwardToolCall(server, toolName, args) {
+    return server.client.callTool({
+        name: toolName,
+        arguments: args,
+    });
+}
+//# sourceMappingURL=proxy.js.map

package/dist/proxy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"proxy.js","sourceRoot":"","sources":["../src/proxy.ts"],"names":[],"mappings":"AAGA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAAwB,EACxB,QAAgB,EAChB,IAA6B;IAE7B,OAAO,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;QAC5B,IAAI,EAAE,QAAQ;QACd,SAAS,EAAE,IAAI;KAChB,CAA4B,CAAC;AAChC,CAAC"}

package/dist/proxy.test.d.ts

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

package/dist/proxy.test.js

@@ -0,0 +1,61 @@
+import { describe, it, expect, vi } from "vitest";
+import { forwardToolCall } from "./proxy.js";
+describe("forwardToolCall", () => {
+    it("calls client.callTool with the correct tool name and arguments", async () => {
+        const callTool = vi.fn().mockResolvedValue({
+            content: [{ type: "text", text: "success" }],
+        });
+        const server = {
+            client: { callTool },
+        };
+        const result = await forwardToolCall(server, "read_file", {
+            path: "/tmp/test.txt",
+        });
+        expect(callTool).toHaveBeenCalledWith({
+            name: "read_file",
+            arguments: { path: "/tmp/test.txt" },
+        });
+        expect(result).toEqual({
+            content: [{ type: "text", text: "success" }],
+        });
+    });
+    it("passes through errors from the upstream server", async () => {
+        const callTool = vi
+            .fn()
+            .mockRejectedValue(new Error("Upstream connection failed"));
+        const server = {
+            client: { callTool },
+        };
+        await expect(forwardToolCall(server, "bad_tool", {})).rejects.toThrow("Upstream connection failed");
+    });
+    it("handles empty arguments", async () => {
+        const callTool = vi.fn().mockResolvedValue({
+            content: [{ type: "text", text: "ok" }],
+        });
+        const server = {
+            client: { callTool },
+        };
+        await forwardToolCall(server, "status", {});
+        expect(callTool).toHaveBeenCalledWith({
+            name: "status",
+            arguments: {},
+        });
+    });
+    it("handles nested arguments", async () => {
+        const callTool = vi.fn().mockResolvedValue({
+            content: [],
+        });
+        const server = {
+            client: { callTool },
+        };
+        await forwardToolCall(server, "complex", {
+            nested: { key: "value" },
+            array: [1, 2, 3],
+        });
+        expect(callTool).toHaveBeenCalledWith({
+            name: "complex",
+            arguments: { nested: { key: "value" }, array: [1, 2, 3] },
+        });
+    });
+});
+//# sourceMappingURL=proxy.test.js.map

package/dist/proxy.test.js.map

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

package/dist/server.d.ts

@@ -0,0 +1,11 @@
+import type { MCPicoConfig } from "./config.js";
+/**
+ * Start the MCPico proxy server.
+ *
+ * 1. Validate config
+ * 2. Connect to all upstream servers
+ * 3. Discover and group their tools
+ * 4. Register grouped tools on the MCPico server
+ * 5. Listen for client connections
+ */
+export declare function startServer(config: MCPicoConfig): Promise<void>;