@sammorrowdrums/mcpi-ext 0.1.0

package/dist/tool-cli/rpc-server.js

@@ -0,0 +1,220 @@
+import http from "node:http";
+import { resolvePort } from "./constants.js";
+/**
+ * JSON-RPC 2.0 server that exposes MCP tool discovery and execution.
+ *
+ * Methods:
+ * - listServers → server names + tool counts + random examples
+ * - listTools(server) → tool names + descriptions
+ * - describeTool(server, tool) → full schema
+ * - callTool(server, tool, arguments) → execute and return result
+ */
+export class ToolCliRpcServer {
+    mcpManager;
+    server = null;
+    port;
+    constructor(mcpManager, port) {
+        this.mcpManager = mcpManager;
+        this.port = port ?? resolvePort();
+    }
+    /** Start the HTTP server. Resolves once listening. */
+    async start(log) {
+        if (this.server)
+            return;
+        const MAX_BODY_SIZE = 1024 * 1024; // 1 MB
+        const server = http.createServer((req, res) => {
+            if (req.method !== "POST") {
+                res.writeHead(405, { "Content-Type": "application/json" });
+                res.end(JSON.stringify(rpcError(null, -32600, "Only POST accepted")));
+                return;
+            }
+            let body = "";
+            let aborted = false;
+            req.on("error", () => {
+                aborted = true;
+            });
+            req.on("data", (chunk) => {
+                if (aborted)
+                    return;
+                body += chunk.toString();
+                if (body.length > MAX_BODY_SIZE) {
+                    aborted = true;
+                    res.writeHead(413, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify(rpcError(null, -32600, "Request too large")));
+                    req.destroy();
+                }
+            });
+            req.on("end", () => {
+                if (aborted)
+                    return;
+                void this.handleBody(body)
+                    .then((response) => {
+                    res.writeHead(200, { "Content-Type": "application/json" });
+                    res.end(JSON.stringify(response));
+                })
+                    .catch(() => {
+                    try {
+                        res.writeHead(500, { "Content-Type": "application/json" });
+                        res.end(JSON.stringify(rpcError(null, -32603, "Internal error")));
+                    }
+                    catch {
+                        res.end();
+                    }
+                });
+            });
+        });
+        return new Promise((resolve, reject) => {
+            server.once("error", (err) => {
+                this.server = null;
+                reject(err);
+            });
+            server.listen(this.port, "127.0.0.1", () => {
+                this.server = server;
+                log?.(`[tool-cli] RPC server listening on 127.0.0.1:${this.port}`);
+                resolve();
+            });
+        });
+    }
+    /** Stop the HTTP server. */
+    async stop() {
+        const server = this.server;
+        if (!server)
+            return;
+        this.server = null;
+        return new Promise((resolve) => {
+            server.close(() => resolve());
+        });
+    }
+    /** Returns the port the server is listening on (resolved after start for port 0). */
+    getPort() {
+        if (this.server) {
+            const addr = this.server.address();
+            if (addr && typeof addr === "object")
+                return addr.port;
+        }
+        return this.port;
+    }
+    async handleBody(body) {
+        let parsed;
+        try {
+            parsed = JSON.parse(body);
+        }
+        catch {
+            return rpcError(null, -32700, "Parse error");
+        }
+        if (parsed.jsonrpc !== "2.0" || !parsed.method) {
+            return rpcError(parsed.id ?? null, -32600, "Invalid Request");
+        }
+        try {
+            const result = await this.dispatch(parsed.method, parsed.params ?? {});
+            return { jsonrpc: "2.0", result, id: parsed.id ?? null };
+        }
+        catch (err) {
+            const message = err instanceof Error ? err.message : String(err);
+            const code = err instanceof RpcMethodError ? err.code : -32603;
+            return rpcError(parsed.id ?? null, code, message);
+        }
+    }
+    async dispatch(method, params) {
+        switch (method) {
+            case "listServers":
+                return this.listServers();
+            case "listTools":
+                return this.listTools(params);
+            case "describeTool":
+                return this.describeTool(params);
+            case "callTool":
+                return this.callTool(params);
+            default:
+                throw new RpcMethodError(-32601, `Method not found: ${method}`);
+        }
+    }
+    listServers() {
+        const serverNames = this.mcpManager.getConnectedServers();
+        const servers = serverNames.map((name) => {
+            const tools = this.mcpManager.getToolsForServer(name);
+            return {
+                name,
+                toolCount: tools.length,
+                examples: pickRandomExamples(tools, 3),
+            };
+        });
+        return { servers };
+    }
+    listTools(params) {
+        const server = requireString(params, "server");
+        this.assertServerExists(server);
+        const tools = this.mcpManager.getToolsForServer(server);
+        return {
+            server,
+            tools: tools.map((t) => ({
+                name: t.name,
+                description: t.description ?? "(no description)",
+                hasStructuredOutput: t.outputSchema != null,
+            })),
+        };
+    }
+    describeTool(params) {
+        const server = requireString(params, "server");
+        const toolName = requireString(params, "tool");
+        this.assertServerExists(server);
+        const tool = this.mcpManager.getToolsForServer(server).find((t) => t.name === toolName);
+        if (!tool) {
+            throw new RpcMethodError(-32602, `Tool "${toolName}" not found on server "${server}"`);
+        }
+        return {
+            name: tool.name,
+            description: tool.description ?? "(no description)",
+            inputSchema: tool.inputSchema,
+            outputSchema: tool.outputSchema,
+            annotations: tool.annotations,
+        };
+    }
+    async callTool(params) {
+        const server = requireString(params, "server");
+        const toolName = requireString(params, "tool");
+        this.assertServerExists(server);
+        const client = this.mcpManager.getClient(server);
+        if (!client) {
+            throw new RpcMethodError(-32603, `No client for server "${server}"`);
+        }
+        const toolArgs = params.arguments ?? {};
+        const result = await client.callTool({ name: toolName, arguments: toolArgs });
+        return {
+            content: result.content,
+            isError: result.isError === true ? true : undefined,
+            structuredContent: result.structuredContent,
+        };
+    }
+    assertServerExists(server) {
+        if (!this.mcpManager.getConnectedServers().includes(server)) {
+            throw new RpcMethodError(-32602, `Server "${server}" not found. Connected: ${this.mcpManager.getConnectedServers().join(", ") || "(none)"}`);
+        }
+    }
+}
+class RpcMethodError extends Error {
+    code;
+    constructor(code, message) {
+        super(message);
+        this.code = code;
+        this.name = "RpcMethodError";
+    }
+}
+function rpcError(id, code, message) {
+    return { jsonrpc: "2.0", error: { code, message }, id };
+}
+function requireString(params, key) {
+    const val = params[key];
+    if (typeof val !== "string" || val.length === 0) {
+        throw new RpcMethodError(-32602, `Missing or invalid parameter: "${key}" (string required)`);
+    }
+    return val;
+}
+/** Pick up to `n` random tool names from a list. */
+function pickRandomExamples(tools, n) {
+    if (tools.length <= n)
+        return tools.map((t) => t.name);
+    const shuffled = [...tools].sort(() => Math.random() - 0.5);
+    return shuffled.slice(0, n).map((t) => t.name);
+}
+//# sourceMappingURL=rpc-server.js.map

package/dist/tool-cli/rpc-server.js.map

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

package/dist/tool-cli/rpc-server.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=rpc-server.test.d.ts.map

package/dist/tool-cli/rpc-server.test.d.ts.map

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

package/dist/tool-cli/rpc-server.test.js

@@ -0,0 +1,154 @@
+import { describe, it, expect, beforeAll, afterAll } from "vitest";
+import { ToolCliRpcServer } from "./rpc-server.js";
+/** Minimal mock of McpClientManager for RPC server testing. */
+function createMockManager() {
+    const tools = [
+        {
+            name: "get_weather",
+            description: "Get current weather for a city",
+            inputSchema: {
+                type: "object",
+                properties: { city: { type: "string", description: "City name" } },
+                required: ["city"],
+            },
+            annotations: { readOnlyHint: true },
+            serverName: "weather",
+        },
+        {
+            name: "set_alarm",
+            description: "Set a weather alarm",
+            inputSchema: {
+                type: "object",
+                properties: {
+                    city: { type: "string" },
+                    threshold: { type: "number" },
+                },
+                required: ["city", "threshold"],
+            },
+            annotations: { readOnlyHint: false, destructiveHint: false },
+            serverName: "weather",
+        },
+        {
+            name: "search_docs",
+            description: "Search documentation",
+            inputSchema: {
+                type: "object",
+                properties: { query: { type: "string", description: "Search query" } },
+                required: ["query"],
+            },
+            outputSchema: {
+                type: "object",
+                properties: { results: { type: "array" } },
+            },
+            annotations: { readOnlyHint: true },
+            serverName: "docs",
+        },
+    ];
+    return {
+        getConnectedServers: () => ["weather", "docs"],
+        getToolsForServer: (name) => tools.filter((t) => t.serverName === name),
+        getTools: () => tools,
+        getClient: (name) => {
+            if (name === "weather" || name === "docs") {
+                return {
+                    callTool: async (params) => ({
+                        content: [{ type: "text", text: `Called ${params.name}` }],
+                    }),
+                };
+            }
+            return undefined;
+        },
+    };
+}
+// Use port 0 so the OS assigns a free port — avoids collisions when src + dist tests run together
+describe("ToolCliRpcServer", () => {
+    let server;
+    let port;
+    beforeAll(async () => {
+        const manager = createMockManager();
+        server = new ToolCliRpcServer(manager, 0);
+        await server.start();
+        port = server.getPort();
+    });
+    afterAll(async () => {
+        await server.stop();
+    });
+    async function rpc(method, params = {}) {
+        const res = await fetch(`http://127.0.0.1:${port}`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ jsonrpc: "2.0", method, params, id: 1 }),
+        });
+        return res.json();
+    }
+    it("lists connected servers with tool counts", async () => {
+        const resp = (await rpc("listServers"));
+        const { servers } = resp.result;
+        expect(servers).toHaveLength(2);
+        const weather = servers.find((s) => s.name === "weather");
+        expect(weather).toBeDefined();
+        expect(weather?.toolCount).toBe(2);
+        expect(weather?.examples.length).toBeGreaterThan(0);
+        const docs = servers.find((s) => s.name === "docs");
+        expect(docs).toBeDefined();
+        expect(docs?.toolCount).toBe(1);
+    });
+    it("lists tools for a specific server", async () => {
+        const resp = (await rpc("listTools", { server: "weather" }));
+        expect(resp.result.server).toBe("weather");
+        expect(resp.result.tools).toHaveLength(2);
+        expect(resp.result.tools[0].name).toBe("get_weather");
+        expect(resp.result.tools[1].name).toBe("set_alarm");
+    });
+    it("describes a tool with full schema", async () => {
+        const resp = (await rpc("describeTool", { server: "weather", tool: "get_weather" }));
+        expect(resp.result.name).toBe("get_weather");
+        expect(resp.result.description).toBe("Get current weather for a city");
+        expect(resp.result.inputSchema).toHaveProperty("properties");
+        expect(resp.result.annotations).toEqual({ readOnlyHint: true });
+    });
+    it("calls a tool and returns result", async () => {
+        const resp = (await rpc("callTool", {
+            server: "weather",
+            tool: "get_weather",
+            arguments: { city: "London" },
+        }));
+        expect(resp.result.content).toHaveLength(1);
+        expect(resp.result.content[0].text).toBe("Called get_weather");
+    });
+    it("returns error for unknown server", async () => {
+        const resp = (await rpc("listTools", { server: "nonexistent" }));
+        expect(resp.error).toBeDefined();
+        expect(resp.error.code).toBe(-32602);
+        expect(resp.error.message).toContain("not found");
+    });
+    it("returns error for unknown tool", async () => {
+        const resp = (await rpc("describeTool", { server: "weather", tool: "nonexistent" }));
+        expect(resp.error).toBeDefined();
+        expect(resp.error.message).toContain("not found");
+    });
+    it("returns error for unknown method", async () => {
+        const resp = (await rpc("unknownMethod"));
+        expect(resp.error).toBeDefined();
+        expect(resp.error.code).toBe(-32601);
+    });
+    it("returns error for missing required params", async () => {
+        const resp = (await rpc("listTools", {}));
+        expect(resp.error).toBeDefined();
+        expect(resp.error.code).toBe(-32602);
+    });
+    it("rejects non-POST requests", async () => {
+        const res = await fetch(`http://127.0.0.1:${port}`, { method: "GET" });
+        expect(res.status).toBe(405);
+    });
+    it("handles malformed JSON gracefully", async () => {
+        const res = await fetch(`http://127.0.0.1:${port}`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: "not json at all",
+        });
+        const json = (await res.json());
+        expect(json.error.code).toBe(-32700);
+    });
+});
+//# sourceMappingURL=rpc-server.test.js.map

package/dist/tool-cli/rpc-server.test.js.map

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

package/eslint.config.js

@@ -0,0 +1,27 @@
+import eslint from "@eslint/js";
+import tseslint from "typescript-eslint";
+import eslintConfigPrettier from "eslint-config-prettier";
+
+export default tseslint.config(
+  eslint.configs.recommended,
+  ...tseslint.configs.strict,
+  ...tseslint.configs.stylistic,
+  eslintConfigPrettier,
+  {
+    languageOptions: {
+      parserOptions: {
+        projectService: true,
+        tsconfigRootDir: import.meta.dirname,
+      },
+    },
+    rules: {
+      "@typescript-eslint/no-unused-vars": [
+        "error",
+        { argsIgnorePattern: "^_", varsIgnorePattern: "^_" },
+      ],
+    },
+  },
+  {
+    ignores: ["dist/", "node_modules/", "*.js", "scripts/"],
+  },
+);

package/mise.toml

@@ -0,0 +1,65 @@
+[tools]
+node = "22"
+
+[tasks.build]
+description = "Build TypeScript"
+run = [
+  "npx tsc",
+  "chmod +x dist/tool-cli/cli.js",
+]
+
+[tasks."install:tool-cli"]
+description = "Symlink tool-cli binary for local use"
+depends = ["build"]
+run = [
+  "ln -sf ../../dist/tool-cli/cli.js node_modules/.bin/tool-cli",
+  "mkdir -p ~/.local/bin",
+  "ln -sf $PWD/dist/tool-cli/cli.js ~/.local/bin/tool-cli",
+]
+
+[tasks.dev]
+description = "Watch mode"
+run = "npx tsc --watch"
+
+[tasks.test]
+description = "Run tests"
+run = "npx vitest --run"
+
+[tasks.check]
+description = "Type-check without emitting"
+run = "npx tsc --noEmit"
+
+[tasks.lint]
+description = "Lint TypeScript files"
+run = "npx eslint ."
+
+[tasks.format]
+description = "Format code with Prettier"
+run = "npx prettier --write ."
+
+[tasks."format:check"]
+description = "Check code formatting"
+run = "npx prettier --check ."
+
+[tasks.start]
+description = "Run the built project"
+run = "node dist/index.js"
+
+[tasks.docker-build]
+description = "Build the Docker e2e image"
+run = "docker build -t mcpi-ext-e2e ."
+
+[tasks."test:integration"]
+description = "Run MCP integration smoke test"
+depends = ["build"]
+run = "node scripts/test-mcp-integration.mjs"
+
+[tasks."test:tool-cli"]
+description = "Run tool-cli smoke test (requires build)"
+depends = ["build"]
+run = "node scripts/test-tool-cli-smoke.mjs"
+
+[tasks."test:skill-integration"]
+description = "Run skill discovery integration test (requires build)"
+depends = ["build"]
+run = "npx vitest run src/skills/skill-integration.test.ts"

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@sammorrowdrums/mcpi-ext",
+  "version": "0.1.0",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "isolated-vm": "^6.1.2",
+    "typebox": "^1.1.31",
+    "zod": "^4.3.6"
+  },
+  "peerDependencies": {
+    "@sammorrowdrums/mcpi": ">=0.70.0"
+  },
+  "devDependencies": {
+    "@sammorrowdrums/mcpi": "file:../../../repos/pi-mono/packages/coding-agent",
+    "@eslint/js": "^10.0.1",
+    "@types/node": "^25.6.0",
+    "eslint": "^10.2.1",
+    "eslint-config-prettier": "^10.1.8",
+    "prettier": "^3.8.3",
+    "typescript": "^6.0.3",
+    "typescript-eslint": "^8.59.0",
+    "vitest": "^4.1.5"
+  },
+  "scripts": {
+    "build": "tsc",
+    "check": "tsc --noEmit",
+    "dev": "tsc --watch",
+    "format": "prettier --write .",
+    "format:check": "prettier --check .",
+    "lint": "eslint .",
+    "lint:fix": "eslint --fix .",
+    "start": "node dist/index.js",
+    "test": "vitest --run"
+  },
+  "engines": {
+    "node": ">=22.13.0"
+  },
+  "description": "MCP extension for mcpi — tiered progressive tool discovery",
+  "license": "MIT",
+  "main": "./dist/index.js",
+  "type": "module",
+  "types": "./dist/index.d.ts",
+  "bin": {
+    "tool-cli": "./dist/tool-cli/cli.js"
+  }
+}

package/scripts/docker-entrypoint.sh

@@ -0,0 +1,29 @@
+#!/usr/bin/env bash
+set -euo pipefail
+
+if [ -z "${GITHUB_TOKEN:-}" ]; then
+  echo "ERROR: GITHUB_TOKEN environment variable is required" >&2
+  exit 1
+fi
+
+if [ $# -eq 0 ]; then
+  echo "ERROR: No task provided. Pass the task as arguments." >&2
+  echo "Usage: docker run -e GITHUB_TOKEN=... IMAGE \"your task here\"" >&2
+  exit 1
+fi
+
+TASK="$*"
+
+PI_ARGS=(
+  -e /app/dist/index.js
+  --provider github-copilot
+  --mode json
+  -p
+  --no-session
+)
+
+if [ -n "${PI_MODEL:-}" ]; then
+  PI_ARGS+=(--model "$PI_MODEL")
+fi
+
+exec npx pi "${PI_ARGS[@]}" "$TASK"

package/scripts/test-echo-server.mjs

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+/**
+ * Minimal MCP server for integration testing.
+ * Exposes a single "echo" tool that returns its input.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const server = new McpServer({
+  name: "test-echo-server",
+  version: "0.1.0",
+});
+
+server.registerTool(
+  "echo",
+  {
+    description: "Echoes back the input message",
+    inputSchema: { message: z.string() },
+    annotations: { readOnlyHint: true },
+  },
+  async ({ message }) => ({
+    content: [{ type: "text", text: message }],
+  }),
+);
+
+const transport = new StdioServerTransport();
+await server.connect(transport);