@schemyx/mcp 0.1.0

package/README.md

@@ -0,0 +1,44 @@
+# @schemyx/mcp
+
+Local stdio MCP server for reading Schemyx project configs, Theme Forge artifacts, target-stack guidance, and implementation notes.
+
+## Usage
+
+```bash
+SCHEMYX_API_KEY=skx_live_replace_me npx -y @schemyx/mcp
+```
+
+MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "schemyx": {
+      "command": "npx",
+      "args": ["-y", "@schemyx/mcp@latest"],
+      "env": {
+        "SCHEMYX_API_KEY": "$SCHEMYX_API_KEY"
+      }
+    }
+  }
+}
+```
+
+## Environment
+
+- `SCHEMYX_API_KEY`: required Schemyx API key with `mcp:read` or `configs:read`
+- `SCHEMYX_API_URL`: optional API base URL, defaults to `https://api.schemyx.com`
+- `SCHEMYX_PROJECT_ID`: optional project filter
+- `SCHEMYX_CONFIG_ID`: optional config filter
+- `SCHEMYX_MCP_CACHE_TTL_MS`: optional discovery cache TTL, defaults to `10000`
+
+## Development
+
+From the backend repo root:
+
+```bash
+npm run build:mcp
+SCHEMYX_API_URL=http://localhost:4000 \
+SCHEMYX_API_KEY=skx_test_replace_me \
+npm run mcp:local
+```

package/dist/backend-client.d.ts

@@ -0,0 +1,17 @@
+import { BackendConfigManifest, BackendResourceContent, BackendToolResult, DiscoveredConfig, LocalMcpConfig, McpConfigResponse, McpContextResponse } from './types';
+export declare class SchemyxBackendClient {
+    private readonly config;
+    private contextCache;
+    private manifestCache;
+    constructor(config: LocalMcpConfig);
+    getContext(): Promise<McpContextResponse>;
+    listConfigs(): Promise<McpConfigResponse[]>;
+    discoverConfigs(): Promise<DiscoveredConfig[]>;
+    getManifest(configId: string): Promise<BackendConfigManifest>;
+    getLatestConfig(configId: string): Promise<McpConfigResponse>;
+    readResource(configId: string, resourceId: string): Promise<BackendResourceContent>;
+    executeTool(configId: string, toolName: string, args: Record<string, unknown>): Promise<BackendToolResult>;
+    resolveConfigId(configId: string | undefined): Promise<string>;
+    private request;
+    private cacheEntry;
+}

package/dist/backend-client.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SchemyxBackendClient = void 0;
+class SchemyxBackendClient {
+    config;
+    contextCache = null;
+    manifestCache = new Map();
+    constructor(config) {
+        this.config = config;
+    }
+    async getContext() {
+        const cached = this.contextCache;
+        if (cached && cached.expiresAt > Date.now()) {
+            return cached.value;
+        }
+        const value = await this.request('/mcp/context');
+        this.contextCache = this.cacheEntry(value);
+        return value;
+    }
+    async listConfigs() {
+        const context = await this.getContext();
+        const configs = context.projects
+            .filter((project) => !this.config.projectId || project.id === this.config.projectId)
+            .flatMap((project) => project.configs);
+        if (this.config.configId) {
+            return configs.filter((config) => config.id === this.config.configId);
+        }
+        return configs;
+    }
+    async discoverConfigs() {
+        const configs = await this.listConfigs();
+        return Promise.all(configs.map(async (config) => ({
+            config,
+            manifest: await this.getManifest(config.id),
+        })));
+    }
+    async getManifest(configId) {
+        const cached = this.manifestCache.get(configId);
+        if (cached && cached.expiresAt > Date.now()) {
+            return cached.value;
+        }
+        const value = await this.request(`/mcp/configs/${configId}/manifest`);
+        this.manifestCache.set(configId, this.cacheEntry(value));
+        return value;
+    }
+    async getLatestConfig(configId) {
+        return this.request(`/mcp/configs/${configId}/latest`);
+    }
+    async readResource(configId, resourceId) {
+        return this.request(`/mcp/configs/${configId}/resources/${encodeURIComponent(resourceId)}`);
+    }
+    async executeTool(configId, toolName, args) {
+        return this.request(`/mcp/configs/${configId}/tools/${encodeURIComponent(toolName)}`, {
+            method: 'POST',
+            body: JSON.stringify({ arguments: args }),
+        });
+    }
+    async resolveConfigId(configId) {
+        if (configId) {
+            return configId;
+        }
+        const configs = await this.listConfigs();
+        if (configs.length === 1) {
+            return configs[0].id;
+        }
+        if (configs.length === 0) {
+            throw new Error('No Schemyx configs are available for this API key.');
+        }
+        throw new Error('Multiple configs are available. Pass configId to choose one.');
+    }
+    async request(path, init) {
+        const response = await fetch(`${this.config.apiUrl}${path}`, {
+            ...init,
+            headers: {
+                Accept: 'application/json',
+                Authorization: `Bearer ${this.config.apiKey}`,
+                ...(init?.body ? { 'Content-Type': 'application/json' } : {}),
+                ...init?.headers,
+            },
+        });
+        if (!response.ok) {
+            throw new Error(`Schemyx API request failed: ${response.status} ${response.statusText} ${await response.text()}`);
+        }
+        return (await response.json());
+    }
+    cacheEntry(value) {
+        return {
+            expiresAt: Date.now() + this.config.cacheTtlMs,
+            value,
+        };
+    }
+}
+exports.SchemyxBackendClient = SchemyxBackendClient;
+//# sourceMappingURL=backend-client.js.map

package/dist/backend-client.js.map

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

package/dist/config.d.ts

@@ -0,0 +1,2 @@
+import { LocalMcpConfig } from './types';
+export declare function loadLocalMcpConfig(env?: NodeJS.ProcessEnv): LocalMcpConfig;

package/dist/config.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadLocalMcpConfig = loadLocalMcpConfig;
+const defaultApiUrl = 'https://api.schemyx.com';
+const defaultCacheTtlMs = 10_000;
+function loadLocalMcpConfig(env = process.env) {
+    const apiKey = env.SCHEMYX_API_KEY?.trim();
+    if (!apiKey) {
+        throw new Error('SCHEMYX_API_KEY is required to start the Schemyx MCP server.');
+    }
+    return {
+        apiUrl: normalizeApiUrl(env.SCHEMYX_API_URL ?? defaultApiUrl),
+        apiKey,
+        projectId: optionalValue(env.SCHEMYX_PROJECT_ID),
+        configId: optionalValue(env.SCHEMYX_CONFIG_ID),
+        cacheTtlMs: parseCacheTtl(env.SCHEMYX_MCP_CACHE_TTL_MS),
+    };
+}
+function normalizeApiUrl(value) {
+    const trimmed = value.trim();
+    if (!trimmed) {
+        return defaultApiUrl;
+    }
+    return trimmed.replace(/\/+$/, '');
+}
+function optionalValue(value) {
+    const trimmed = value?.trim();
+    return trimmed ? trimmed : undefined;
+}
+function parseCacheTtl(value) {
+    if (!value) {
+        return defaultCacheTtlMs;
+    }
+    const parsed = Number(value);
+    if (!Number.isFinite(parsed) || parsed < 0) {
+        throw new Error('SCHEMYX_MCP_CACHE_TTL_MS must be a non-negative number.');
+    }
+    return parsed;
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":";;AAKA,gDAcC;AAjBD,MAAM,aAAa,GAAG,yBAAyB,CAAC;AAChD,MAAM,iBAAiB,GAAG,MAAM,CAAC;AAEjC,SAAgB,kBAAkB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACrE,MAAM,MAAM,GAAG,GAAG,CAAC,eAAe,EAAE,IAAI,EAAE,CAAC;IAE3C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,MAAM,IAAI,KAAK,CAAC,8DAA8D,CAAC,CAAC;IAClF,CAAC;IAED,OAAO;QACL,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,eAAe,IAAI,aAAa,CAAC;QAC7D,MAAM;QACN,SAAS,EAAE,aAAa,CAAC,GAAG,CAAC,kBAAkB,CAAC;QAChD,QAAQ,EAAE,aAAa,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC9C,UAAU,EAAE,aAAa,CAAC,GAAG,CAAC,wBAAwB,CAAC;KACxD,CAAC;AACJ,CAAC;AAED,SAAS,eAAe,CAAC,KAAa;IACpC,MAAM,OAAO,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAE7B,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,OAAO,aAAa,CAAC;IACvB,CAAC;IAED,OAAO,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,SAAS,aAAa,CAAC,KAAyB;IAC9C,MAAM,OAAO,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC;IAE9B,OAAO,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;AACvC,CAAC;AAED,SAAS,aAAa,CAAC,KAAyB;IAC9C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,iBAAiB,CAAC;IAC3B,CAAC;IAED,MAAM,MAAM,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAE7B,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,yDAAyD,CAAC,CAAC;IAC7E,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/main.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/main.js

@@ -0,0 +1,15 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const backend_client_1 = require("./backend-client");
+const config_1 = require("./config");
+const server_1 = require("./server");
+async function main() {
+    const config = (0, config_1.loadLocalMcpConfig)();
+    await (0, server_1.runLocalMcpServer)(new backend_client_1.SchemyxBackendClient(config));
+}
+main().catch((error) => {
+    console.error(error instanceof Error ? error.message : error);
+    process.exit(1);
+});
+//# sourceMappingURL=main.js.map

package/dist/main.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":";;;AACA,qDAAwD;AACxD,qCAA8C;AAC9C,qCAA6C;AAE7C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,IAAA,2BAAkB,GAAE,CAAC;IACpC,MAAM,IAAA,0BAAiB,EAAC,IAAI,qCAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC5D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/prompts.d.ts

@@ -0,0 +1,7 @@
+import { GetPromptResult, Prompt } from '@modelcontextprotocol/sdk/types.js';
+import { SchemyxBackendClient } from './backend-client';
+export declare const localPromptNames: {
+    readonly applyTheme: "schemyx_apply_theme";
+};
+export declare const localPrompts: Prompt[];
+export declare function getLocalPrompt(client: SchemyxBackendClient, name: string, args: Record<string, string> | undefined): Promise<GetPromptResult>;

package/dist/prompts.js

@@ -0,0 +1,55 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.localPrompts = exports.localPromptNames = void 0;
+exports.getLocalPrompt = getLocalPrompt;
+const text_1 = require("./text");
+exports.localPromptNames = {
+    applyTheme: 'schemyx_apply_theme',
+};
+exports.localPrompts = [
+    {
+        name: exports.localPromptNames.applyTheme,
+        title: 'Apply Schemyx Theme',
+        description: 'Use the saved Schemyx theme contract before building or restyling UI.',
+        arguments: [
+            {
+                name: 'task',
+                description: 'The UI or product workflow to build.',
+                required: true,
+            },
+            {
+                name: 'configId',
+                description: 'Schemyx config id. Optional when only one config is available.',
+                required: false,
+            },
+        ],
+    },
+];
+async function getLocalPrompt(client, name, args) {
+    if (name !== exports.localPromptNames.applyTheme) {
+        throw new Error(`Unknown Schemyx prompt: ${name}`);
+    }
+    const configId = await client.resolveConfigId(args?.configId);
+    const guide = await client.executeTool(configId, 'theme-forge.get-implementation-guide', {});
+    const task = args?.task ?? 'Build the requested UI.';
+    return {
+        description: 'Apply the saved Schemyx theme contract to a codebase.',
+        messages: [
+            {
+                role: 'user',
+                content: {
+                    type: 'text',
+                    text: [
+                        `Task: ${task}`,
+                        '',
+                        'Use the Schemyx config as source of truth before writing UI code.',
+                        'Read generated artifacts from this MCP server instead of inventing colors, radius, spacing, shadows, or typography.',
+                        '',
+                        (0, text_1.stringifyMcpContent)(guide.content),
+                    ].join('\n'),
+                },
+            },
+        ],
+    };
+}
+//# sourceMappingURL=prompts.js.map

package/dist/prompts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompts.js","sourceRoot":"","sources":["../src/prompts.ts"],"names":[],"mappings":";;;AA4BA,wCAgCC;AA1DD,iCAA6C;AAEhC,QAAA,gBAAgB,GAAG;IAC9B,UAAU,EAAE,qBAAqB;CACzB,CAAC;AAEE,QAAA,YAAY,GAAa;IACpC;QACE,IAAI,EAAE,wBAAgB,CAAC,UAAU;QACjC,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,uEAAuE;QACpF,SAAS,EAAE;YACT;gBACE,IAAI,EAAE,MAAM;gBACZ,WAAW,EAAE,sCAAsC;gBACnD,QAAQ,EAAE,IAAI;aACf;YACD;gBACE,IAAI,EAAE,UAAU;gBAChB,WAAW,EAAE,gEAAgE;gBAC7E,QAAQ,EAAE,KAAK;aAChB;SACF;KACF;CACF,CAAC;AAEK,KAAK,UAAU,cAAc,CAClC,MAA4B,EAC5B,IAAY,EACZ,IAAwC;IAExC,IAAI,IAAI,KAAK,wBAAgB,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CAAC,2BAA2B,IAAI,EAAE,CAAC,CAAC;IACrD,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC9D,MAAM,KAAK,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,QAAQ,EAAE,sCAAsC,EAAE,EAAE,CAAC,CAAC;IAC7F,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,yBAAyB,CAAC;IAErD,OAAO;QACL,WAAW,EAAE,uDAAuD;QACpE,QAAQ,EAAE;YACR;gBACE,IAAI,EAAE,MAAM;gBACZ,OAAO,EAAE;oBACP,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE;wBACJ,SAAS,IAAI,EAAE;wBACf,EAAE;wBACF,mEAAmE;wBACnE,qHAAqH;wBACrH,EAAE;wBACF,IAAA,0BAAmB,EAAC,KAAK,CAAC,OAAO,CAAC;qBACnC,CAAC,IAAI,CAAC,IAAI,CAAC;iBACb;aACF;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,4 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { SchemyxBackendClient } from './backend-client';
+export declare function createLocalMcpServer(client: SchemyxBackendClient): Server;
+export declare function runLocalMcpServer(client: SchemyxBackendClient): Promise<void>;

package/dist/server.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createLocalMcpServer = createLocalMcpServer;
+exports.runLocalMcpServer = runLocalMcpServer;
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const prompts_1 = require("./prompts");
+const text_1 = require("./text");
+const uri_1 = require("./uri");
+const tool_definitions_1 = require("./tool-definitions");
+function createLocalMcpServer(client) {
+    const server = new index_js_1.Server({
+        name: 'schemyx-mcp',
+        version: '0.1.0',
+    }, {
+        capabilities: {
+            resources: { listChanged: true },
+            tools: { listChanged: true },
+            prompts: { listChanged: true },
+        },
+        instructions: 'Use Schemyx resources and tools to read approved project configs, Theme Forge artifacts, and implementation guides before generating UI code.',
+    });
+    server.setRequestHandler(types_js_1.ListResourcesRequestSchema, async () => ({
+        resources: await listResources(client),
+    }));
+    server.setRequestHandler(types_js_1.ReadResourceRequestSchema, async (request) => {
+        const { configId, resourceId } = (0, uri_1.parseLocalResourceUri)(request.params.uri);
+        const resource = await client.readResource(configId, resourceId);
+        return {
+            contents: [
+                {
+                    uri: request.params.uri,
+                    mimeType: resource.resource.mimeType,
+                    text: (0, text_1.stringifyMcpContent)(resource.content),
+                    _meta: {
+                        backendUri: resource.resource.uri,
+                        resourceId: resource.resource.id,
+                        configId,
+                    },
+                },
+            ],
+        };
+    });
+    server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => ({
+        tools: tool_definitions_1.localTools,
+    }));
+    server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+        try {
+            return await callLocalTool(client, request.params.name, request.params.arguments ?? {});
+        }
+        catch (error) {
+            return (0, text_1.errorToolResult)(error);
+        }
+    });
+    server.setRequestHandler(types_js_1.ListPromptsRequestSchema, async () => ({
+        prompts: prompts_1.localPrompts,
+    }));
+    server.setRequestHandler(types_js_1.GetPromptRequestSchema, async (request) => (0, prompts_1.getLocalPrompt)(client, request.params.name, request.params.arguments));
+    return server;
+}
+async function runLocalMcpServer(client) {
+    const server = createLocalMcpServer(client);
+    await server.connect(new stdio_js_1.StdioServerTransport());
+}
+async function listResources(client) {
+    const discovered = await client.discoverConfigs();
+    return discovered.flatMap(({ config, manifest }) => manifest.resources.map((resource) => toMcpResource(config, resource)));
+}
+function toMcpResource(config, resource) {
+    return {
+        uri: (0, uri_1.createLocalResourceUri)(config.id, resource.id),
+        name: `${config.key}.${resource.id}`,
+        title: `${config.name}: ${resource.name}`,
+        description: `${resource.description} Config: ${config.name} (${config.key}).`,
+        mimeType: resource.mimeType,
+        _meta: {
+            configId: config.id,
+            configKey: config.key,
+            resourceId: resource.id,
+            backendUri: resource.uri,
+            ...resource.metadata,
+        },
+    };
+}
+async function callLocalTool(client, name, args) {
+    switch (name) {
+        case tool_definitions_1.localToolNames.listConfigs:
+            return (0, text_1.textToolResult)(await client.listConfigs());
+        case tool_definitions_1.localToolNames.getLatestConfig:
+            return (0, text_1.textToolResult)(await client.getLatestConfig(await client.resolveConfigId(stringArg(args, 'configId'))));
+        case tool_definitions_1.localToolNames.getManifest:
+            return (0, text_1.textToolResult)(await client.getManifest(await client.resolveConfigId(stringArg(args, 'configId'))));
+        case tool_definitions_1.localToolNames.readResource:
+            return (0, text_1.textToolResult)((await client.readResource(requiredStringArg(args, 'configId'), requiredStringArg(args, 'resourceId'))).content);
+        case tool_definitions_1.localToolNames.callBackendTool:
+            return (0, text_1.textToolResult)(await client.executeTool(requiredStringArg(args, 'configId'), requiredStringArg(args, 'toolName'), recordArg(args, 'arguments')));
+        case tool_definitions_1.localToolNames.getThemeFile:
+            return (0, text_1.textToolResult)((await client.executeTool(await client.resolveConfigId(stringArg(args, 'configId')), 'theme-forge.get-file', {
+                fileName: stringArg(args, 'fileName'),
+                fileId: stringArg(args, 'fileId'),
+            })).content);
+        case tool_definitions_1.localToolNames.getImplementationGuide:
+            return (0, text_1.textToolResult)((await client.executeTool(await client.resolveConfigId(stringArg(args, 'configId')), 'theme-forge.get-implementation-guide', {})).content);
+        default:
+            throw new Error(`Unknown Schemyx local MCP tool: ${name}`);
+    }
+}
+function stringArg(args, key) {
+    const value = args[key];
+    return typeof value === 'string' && value.trim() ? value : undefined;
+}
+function requiredStringArg(args, key) {
+    const value = stringArg(args, key);
+    if (!value) {
+        throw new Error(`Tool argument "${key}" is required.`);
+    }
+    return value;
+}
+function recordArg(args, key) {
+    const value = args[key];
+    if (!value) {
+        return {};
+    }
+    if (typeof value !== 'object' || Array.isArray(value)) {
+        throw new Error(`Tool argument "${key}" must be an object.`);
+    }
+    return value;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/text.d.ts

@@ -0,0 +1,14 @@
+export declare function stringifyMcpContent(value: unknown): string;
+export declare function textToolResult(value: unknown): {
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};
+export declare function errorToolResult(error: unknown): {
+    isError: boolean;
+    content: {
+        type: "text";
+        text: string;
+    }[];
+};

package/dist/text.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringifyMcpContent = stringifyMcpContent;
+exports.textToolResult = textToolResult;
+exports.errorToolResult = errorToolResult;
+function stringifyMcpContent(value) {
+    if (typeof value === 'string') {
+        return value;
+    }
+    return JSON.stringify(value, null, 2);
+}
+function textToolResult(value) {
+    return {
+        content: [
+            {
+                type: 'text',
+                text: stringifyMcpContent(value),
+            },
+        ],
+    };
+}
+function errorToolResult(error) {
+    return {
+        isError: true,
+        content: [
+            {
+                type: 'text',
+                text: error instanceof Error ? error.message : String(error),
+            },
+        ],
+    };
+}
+//# sourceMappingURL=text.js.map

package/dist/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","sourceRoot":"","sources":["../src/text.ts"],"names":[],"mappings":";;AAAA,kDAMC;AAED,wCASC;AAED,0CAUC;AA7BD,SAAgB,mBAAmB,CAAC,KAAc;IAChD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACf,CAAC;IAED,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,SAAgB,cAAc,CAAC,KAAc;IAC3C,OAAO;QACL,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,mBAAmB,CAAC,KAAK,CAAC;aACjC;SACF;KACF,CAAC;AACJ,CAAC;AAED,SAAgB,eAAe,CAAC,KAAc;IAC5C,OAAO;QACL,OAAO,EAAE,IAAI;QACb,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAe;gBACrB,IAAI,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC;aAC7D;SACF;KACF,CAAC;AACJ,CAAC"}

package/dist/tool-definitions.d.ts

@@ -0,0 +1,11 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const localToolNames: {
+    readonly listConfigs: "schemyx_list_configs";
+    readonly getLatestConfig: "schemyx_get_latest_config";
+    readonly getManifest: "schemyx_get_manifest";
+    readonly readResource: "schemyx_read_resource";
+    readonly callBackendTool: "schemyx_call_backend_tool";
+    readonly getThemeFile: "schemyx_get_theme_file";
+    readonly getImplementationGuide: "schemyx_get_implementation_guide";
+};
+export declare const localTools: Tool[];

package/dist/tool-definitions.js

@@ -0,0 +1,130 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.localTools = exports.localToolNames = void 0;
+exports.localToolNames = {
+    listConfigs: 'schemyx_list_configs',
+    getLatestConfig: 'schemyx_get_latest_config',
+    getManifest: 'schemyx_get_manifest',
+    readResource: 'schemyx_read_resource',
+    callBackendTool: 'schemyx_call_backend_tool',
+    getThemeFile: 'schemyx_get_theme_file',
+    getImplementationGuide: 'schemyx_get_implementation_guide',
+};
+exports.localTools = [
+    {
+        name: exports.localToolNames.listConfigs,
+        title: 'List Schemyx Configs',
+        description: 'List configs available to this Schemyx API key.',
+        inputSchema: objectSchema(),
+        annotations: readOnlyAnnotations(),
+    },
+    {
+        name: exports.localToolNames.getLatestConfig,
+        title: 'Get Latest Schemyx Config',
+        description: 'Read the latest stored config version and metadata.',
+        inputSchema: objectSchema({
+            configId: {
+                type: 'string',
+                description: 'Schemyx config id. Optional when only one config is available.',
+            },
+        }),
+        annotations: readOnlyAnnotations(),
+    },
+    {
+        name: exports.localToolNames.getManifest,
+        title: 'Get Schemyx Config Manifest',
+        description: 'List providers, resources, tools, and prompts for a config.',
+        inputSchema: objectSchema({
+            configId: {
+                type: 'string',
+                description: 'Schemyx config id. Optional when only one config is available.',
+            },
+        }),
+        annotations: readOnlyAnnotations(),
+    },
+    {
+        name: exports.localToolNames.readResource,
+        title: 'Read Schemyx Resource',
+        description: 'Read a backend MCP resource by config id and resource id.',
+        inputSchema: objectSchema({
+            configId: {
+                type: 'string',
+                description: 'Schemyx config id.',
+            },
+            resourceId: {
+                type: 'string',
+                description: 'Resource id from the config manifest, such as theme-forge.file.theme-css.',
+            },
+        }, ['configId', 'resourceId']),
+        annotations: readOnlyAnnotations(),
+    },
+    {
+        name: exports.localToolNames.callBackendTool,
+        title: 'Call Schemyx Backend Tool',
+        description: 'Call a read-only tool exposed by the Schemyx backend config manifest.',
+        inputSchema: objectSchema({
+            configId: {
+                type: 'string',
+                description: 'Schemyx config id.',
+            },
+            toolName: {
+                type: 'string',
+                description: 'Backend tool name from the config manifest.',
+            },
+            arguments: {
+                type: 'object',
+                description: 'Arguments to send to the backend tool.',
+                additionalProperties: true,
+            },
+        }, ['configId', 'toolName']),
+        annotations: readOnlyAnnotations(),
+    },
+    {
+        name: exports.localToolNames.getThemeFile,
+        title: 'Get Theme Forge File',
+        description: 'Read a generated Theme Forge artifact by file name or artifact id.',
+        inputSchema: objectSchema({
+            configId: {
+                type: 'string',
+                description: 'Schemyx config id. Optional when only one config is available.',
+            },
+            fileName: {
+                type: 'string',
+                description: 'Generated file name, such as themeforge.json, theme.css, or shadcn-globals.css.',
+            },
+            fileId: {
+                type: 'string',
+                description: 'Generated file id from the manifest.',
+            },
+        }),
+        annotations: readOnlyAnnotations(),
+    },
+    {
+        name: exports.localToolNames.getImplementationGuide,
+        title: 'Get Theme Implementation Guide',
+        description: 'Read AI-facing instructions for applying a saved Theme Forge theme.',
+        inputSchema: objectSchema({
+            configId: {
+                type: 'string',
+                description: 'Schemyx config id. Optional when only one config is available.',
+            },
+        }),
+        annotations: readOnlyAnnotations(),
+    },
+];
+function objectSchema(properties = {}, required) {
+    return {
+        type: 'object',
+        properties,
+        ...(required ? { required } : {}),
+    };
+}
+function readOnlyAnnotations() {
+    return {
+        readOnlyHint: true,
+        destructiveHint: false,
+        idempotentHint: true,
+        openWorldHint: true,
+    };
+}
+//# sourceMappingURL=tool-definitions.js.map

package/dist/tool-definitions.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,106 @@
+export interface LocalMcpConfig {
+    apiUrl: string;
+    apiKey: string;
+    projectId?: string;
+    configId?: string;
+    cacheTtlMs: number;
+}
+export interface McpConfigResponse {
+    id: string;
+    projectId: string;
+    name: string;
+    key: string;
+    type: string;
+    status: string;
+    source: string;
+    description: string | null;
+    targetPath: string | null;
+    schema: unknown;
+    validation: unknown;
+    metadata: unknown;
+    createdAt: string;
+    updatedAt: string;
+    latestVersion: {
+        id: string;
+        version: number;
+        content: unknown;
+        createdAt: string;
+    } | null;
+}
+export interface McpContextResponse {
+    apiKey: {
+        id: string;
+        teamId: string;
+        projectId: string | null;
+        scopes: unknown;
+    };
+    team: {
+        id: string;
+        name: string;
+        slug: string;
+    };
+    projects: Array<{
+        id: string;
+        teamId: string;
+        name: string;
+        slug: string;
+        description: string | null;
+        configs: McpConfigResponse[];
+    }>;
+}
+export interface BackendResourceDescriptor {
+    id: string;
+    uri: string;
+    name: string;
+    description: string;
+    mimeType: string;
+    kind: 'json' | 'text';
+    metadata?: Record<string, unknown>;
+}
+export interface BackendToolDescriptor {
+    name: string;
+    title: string;
+    description: string;
+    inputSchema: {
+        type: string;
+        properties?: Record<string, unknown>;
+        required?: string[];
+        additionalProperties?: boolean;
+    };
+    readOnly: boolean;
+    metadata?: Record<string, unknown>;
+}
+export interface BackendPromptDescriptor {
+    id: string;
+    name: string;
+    description: string;
+    arguments?: Array<{
+        name: string;
+        description: string;
+        required?: boolean;
+    }>;
+}
+export interface BackendConfigManifest {
+    configId: string;
+    providers: Array<{
+        id: string;
+        name: string;
+    }>;
+    resources: BackendResourceDescriptor[];
+    tools: BackendToolDescriptor[];
+    prompts: BackendPromptDescriptor[];
+}
+export interface BackendResourceContent {
+    resource: BackendResourceDescriptor;
+    content: unknown;
+}
+export interface BackendToolResult {
+    tool: BackendToolDescriptor;
+    content: unknown;
+    contentType: 'json' | 'text';
+    metadata?: Record<string, unknown>;
+}
+export interface DiscoveredConfig {
+    config: McpConfigResponse;
+    manifest: BackendConfigManifest;
+}

package/dist/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

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

package/dist/uri.d.ts

@@ -0,0 +1,6 @@
+export declare const localResourcePrefix = "schemyx://configs/";
+export declare function createLocalResourceUri(configId: string, resourceId: string): string;
+export declare function parseLocalResourceUri(uri: string): {
+    configId: string;
+    resourceId: string;
+};

package/dist/uri.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.localResourcePrefix = void 0;
+exports.createLocalResourceUri = createLocalResourceUri;
+exports.parseLocalResourceUri = parseLocalResourceUri;
+exports.localResourcePrefix = 'schemyx://configs/';
+function createLocalResourceUri(configId, resourceId) {
+    return `${exports.localResourcePrefix}${encodeURIComponent(configId)}/resources/${encodeURIComponent(resourceId)}`;
+}
+function parseLocalResourceUri(uri) {
+    const parsed = new URL(uri);
+    if (parsed.protocol !== 'schemyx:' || parsed.hostname !== 'configs') {
+        throw new Error(`Unsupported Schemyx resource URI: ${uri}`);
+    }
+    const [configId, resourceSegment, resourceId] = parsed.pathname
+        .split('/')
+        .filter((segment) => segment.length > 0)
+        .map((segment) => decodeURIComponent(segment));
+    if (!configId || resourceSegment !== 'resources' || !resourceId) {
+        throw new Error(`Unsupported Schemyx resource URI: ${uri}`);
+    }
+    return { configId, resourceId };
+}
+//# sourceMappingURL=uri.js.map

package/dist/uri.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uri.js","sourceRoot":"","sources":["../src/uri.ts"],"names":[],"mappings":";;;AAEA,wDAIC;AAED,sDAiBC;AAzBY,QAAA,mBAAmB,GAAG,oBAAoB,CAAC;AAExD,SAAgB,sBAAsB,CAAC,QAAgB,EAAE,UAAkB;IACzE,OAAO,GAAG,2BAAmB,GAAG,kBAAkB,CAAC,QAAQ,CAAC,cAAc,kBAAkB,CAC1F,UAAU,CACX,EAAE,CAAC;AACN,CAAC;AAED,SAAgB,qBAAqB,CAAC,GAAW;IAC/C,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC;IAE5B,IAAI,MAAM,CAAC,QAAQ,KAAK,UAAU,IAAI,MAAM,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QACpE,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,MAAM,CAAC,QAAQ,EAAE,eAAe,EAAE,UAAU,CAAC,GAAG,MAAM,CAAC,QAAQ;SAC5D,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;SACvC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC,CAAC;IAEjD,IAAI,CAAC,QAAQ,IAAI,eAAe,KAAK,WAAW,IAAI,CAAC,UAAU,EAAE,CAAC;QAChE,MAAM,IAAI,KAAK,CAAC,qCAAqC,GAAG,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,OAAO,EAAE,QAAQ,EAAE,UAAU,EAAE,CAAC;AAClC,CAAC"}

package/package.json

@@ -0,0 +1,27 @@
+{
+  "name": "@schemyx/mcp",
+  "version": "0.1.0",
+  "description": "Local stdio MCP server for reading Schemyx project configs and Theme Forge artifacts.",
+  "license": "Proprietary",
+  "type": "commonjs",
+  "main": "dist/main.js",
+  "types": "dist/main.d.ts",
+  "bin": {
+    "schemyx-mcp": "dist/main.js"
+  },
+  "files": ["dist", "README.md"],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run build"
+  },
+  "engines": {
+    "node": ">=18"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}