@mushi-mushi/mcp 0.13.0 → 0.14.0

package/dist/server.d.ts

@@ -0,0 +1,54 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { McpScope } from './catalog.js';
+
+/**
+ * FILE: packages/mcp/src/server.ts
+ * PURPOSE: Testable MCP server factory. Exports `createMushiServer()` which
+ *          builds a fully-configured `McpServer` but does not connect to any
+ *          transport — allowing the stdio entry (`src/index.ts`) and the
+ *          in-memory integration tests to share the exact same tool
+ *          implementations. Keeping the module side-effect-free is critical:
+ *          the old design called `main()` at import time, which made it
+ *          impossible to mock `fetch` before the server had wired up its
+ *          closures.
+ *
+ *          Every tool/resource is a thin, typed wrapper over the Mushi REST
+ *          API; auth is an API key sent in two headers so the shared
+ *          `adminOrApiKey` middleware accepts it regardless of which header
+ *          a proxy strips first.
+ */
+
+declare class MushiApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+interface MushiServerConfig {
+    /** Server version — surfaced in MCP handshake. Read from package.json by boot. */
+    version: string;
+    /** Base URL of the Mushi API, e.g. https://xyz.supabase.co/functions/v1/api */
+    apiEndpoint: string;
+    /** Project API key with `mcp:read` or `mcp:write` scope. */
+    apiKey: string;
+    /** Optional project hint. Used to scope multi-project tools. */
+    projectId?: string;
+    /**
+     * Granted scopes from the API key. When provided, only tools/resources that
+     * require a subset of these scopes are registered. Defaults to ALL_SCOPES.
+     */
+    scopes?: readonly McpScope[];
+    /**
+     * Fetch implementation — overridable for tests. Tests pass a spy that
+     * asserts request shape and returns canned envelopes without hitting the
+     * network. Defaults to the global `fetch`.
+     */
+    fetch?: typeof fetch;
+}
+/**
+ * Build an MCP server instance pre-wired with every Mushi tool, resource,
+ * and prompt. Does NOT call `server.connect()` — the caller binds whatever
+ * transport they need (stdio for the CLI, InMemoryTransport for tests).
+ */
+declare function createMushiServer(config: MushiServerConfig): McpServer;
+
+export { MushiApiError, type MushiServerConfig, createMushiServer };