@viyv/agent-ui-mcp 0.1.0

package/.turbo/turbo-build.log

@@ -0,0 +1,4 @@
+
+> @viyv/agent-ui-mcp@0.1.0 build /Users/hiroki/myworkspace/ai_project/viyv-agent-ui/packages/mcp
+> tsc
+

package/.turbo/turbo-test.log

@@ -0,0 +1,15 @@
+
+> @viyv/agent-ui-mcp@0.1.0 test /Users/hiroki/myworkspace/ai_project/viyv-agent-ui/packages/mcp
+> vitest run
+
+
+ RUN  v2.1.9 /Users/hiroki/myworkspace/ai_project/viyv-agent-ui/packages/mcp
+
+ ✓ src/__tests__/api-client.test.ts (5 tests) 5ms
+ ✓ src/__tests__/tools.test.ts (1 test) 4ms
+
+ Test Files  2 passed (2)
+      Tests  6 passed (6)
+   Start at  16:20:39
+   Duration  862ms (transform 146ms, setup 0ms, collect 398ms, tests 9ms, environment 0ms, prepare 203ms)
+

package/.turbo/turbo-typecheck.log

@@ -0,0 +1,4 @@
+
+> @viyv/agent-ui-mcp@0.1.0 typecheck /Users/hiroki/myworkspace/ai_project/viyv-agent-ui/packages/mcp
+> tsc --noEmit
+

package/dist/__tests__/api-client.test.d.ts

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

package/dist/__tests__/api-client.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/api-client.test.ts"],"names":[],"mappings":""}

package/dist/__tests__/api-client.test.js

@@ -0,0 +1,57 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { ApiClient } from '../api-client.js';
+describe('ApiClient', () => {
+    beforeEach(() => {
+        vi.restoreAllMocks();
+    });
+    it('sends GET requests', async () => {
+        const mockResponse = { ok: true, json: () => Promise.resolve([{ id: 'test' }]) };
+        vi.spyOn(globalThis, 'fetch').mockResolvedValue(mockResponse);
+        const client = new ApiClient({ baseUrl: 'http://localhost:3000/api/agent-ui' });
+        const result = await client.get('/pages');
+        expect(fetch).toHaveBeenCalledWith('http://localhost:3000/api/agent-ui/pages', expect.objectContaining({ method: 'GET' }));
+        expect(result).toEqual([{ id: 'test' }]);
+    });
+    it('sends POST requests with body', async () => {
+        const mockResponse = { ok: true, json: () => Promise.resolve({ id: 'new' }) };
+        vi.spyOn(globalThis, 'fetch').mockResolvedValue(mockResponse);
+        const client = new ApiClient({ baseUrl: 'http://localhost:3000/api/agent-ui' });
+        await client.post('/pages', { title: 'Test' });
+        expect(fetch).toHaveBeenCalledWith('http://localhost:3000/api/agent-ui/pages', expect.objectContaining({
+            method: 'POST',
+            body: JSON.stringify({ title: 'Test' }),
+        }));
+    });
+    it('includes API key in Authorization header', async () => {
+        const mockResponse = { ok: true, json: () => Promise.resolve({}) };
+        vi.spyOn(globalThis, 'fetch').mockResolvedValue(mockResponse);
+        const client = new ApiClient({
+            baseUrl: 'http://localhost:3000/api/agent-ui',
+            apiKey: 'test-key',
+        });
+        await client.get('/pages');
+        expect(fetch).toHaveBeenCalledWith(expect.any(String), expect.objectContaining({
+            headers: expect.objectContaining({
+                Authorization: 'Bearer test-key',
+            }),
+        }));
+    });
+    it('throws on non-OK response', async () => {
+        const mockResponse = {
+            ok: false,
+            status: 404,
+            text: () => Promise.resolve('Not found'),
+        };
+        vi.spyOn(globalThis, 'fetch').mockResolvedValue(mockResponse);
+        const client = new ApiClient({ baseUrl: 'http://localhost:3000/api/agent-ui' });
+        await expect(client.get('/pages/missing')).rejects.toThrow('404');
+    });
+    it('sends DELETE requests', async () => {
+        const mockResponse = { ok: true };
+        vi.spyOn(globalThis, 'fetch').mockResolvedValue(mockResponse);
+        const client = new ApiClient({ baseUrl: 'http://localhost:3000/api/agent-ui' });
+        await client.delete('/pages/test');
+        expect(fetch).toHaveBeenCalledWith('http://localhost:3000/api/agent-ui/pages/test', expect.objectContaining({ method: 'DELETE' }));
+    });
+});
+//# sourceMappingURL=api-client.test.js.map

package/dist/__tests__/api-client.test.js.map

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

package/dist/__tests__/tools.test.d.ts

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

package/dist/__tests__/tools.test.d.ts.map

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

package/dist/__tests__/tools.test.js

@@ -0,0 +1,12 @@
+import { describe, expect, it } from 'vitest';
+import { ApiClient } from '../api-client.js';
+import { createMcpServer } from '../server.js';
+// Test the MCP server tools by verifying the server is created correctly
+describe('MCP Server', () => {
+    it('creates a server with correct name and version', () => {
+        const client = new ApiClient({ baseUrl: 'http://localhost:3000/api/agent-ui' });
+        const server = createMcpServer(client);
+        expect(server).toBeDefined();
+    });
+});
+//# sourceMappingURL=tools.test.js.map

package/dist/__tests__/tools.test.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tools.test.js","sourceRoot":"","sources":["../../src/__tests__/tools.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,QAAQ,CAAC;AAC9C,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,yEAAyE;AACzE,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC3B,EAAE,CAAC,gDAAgD,EAAE,GAAG,EAAE;QACzD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC,EAAE,OAAO,EAAE,oCAAoC,EAAE,CAAC,CAAC;QAChF,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;QACvC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAC9B,CAAC,CAAC,CAAC;AACJ,CAAC,CAAC,CAAC"}

package/dist/api-client.d.ts

@@ -0,0 +1,14 @@
+export interface ApiClientOptions {
+    baseUrl: string;
+    apiKey?: string;
+}
+export declare class ApiClient {
+    private baseUrl;
+    private headers;
+    constructor(options: ApiClientOptions);
+    get<T = unknown>(path: string): Promise<T>;
+    post<T = unknown>(path: string, body?: unknown): Promise<T>;
+    put<T = unknown>(path: string, body: unknown): Promise<T>;
+    delete(path: string): Promise<void>;
+}
+//# sourceMappingURL=api-client.d.ts.map

package/dist/api-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"api-client.d.ts","sourceRoot":"","sources":["../src/api-client.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,gBAAgB;IAChC,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,qBAAa,SAAS;IACrB,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,OAAO,CAAyB;gBAE5B,OAAO,EAAE,gBAAgB;IAU/B,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAY1C,IAAI,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAa3D,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,CAAC,CAAC;IAazD,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAUzC"}

package/dist/api-client.js

@@ -0,0 +1,59 @@
+export class ApiClient {
+    baseUrl;
+    headers;
+    constructor(options) {
+        this.baseUrl = options.baseUrl.replace(/\/$/, '');
+        this.headers = {
+            'Content-Type': 'application/json',
+        };
+        if (options.apiKey) {
+            this.headers.Authorization = `Bearer ${options.apiKey}`;
+        }
+    }
+    async get(path) {
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method: 'GET',
+            headers: this.headers,
+        });
+        if (!response.ok) {
+            const body = await response.text();
+            throw new Error(`API GET ${path} failed: ${response.status} - ${body}`);
+        }
+        return response.json();
+    }
+    async post(path, body) {
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method: 'POST',
+            headers: this.headers,
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`API POST ${path} failed: ${response.status} - ${text}`);
+        }
+        return response.json();
+    }
+    async put(path, body) {
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method: 'PUT',
+            headers: this.headers,
+            body: JSON.stringify(body),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`API PUT ${path} failed: ${response.status} - ${text}`);
+        }
+        return response.json();
+    }
+    async delete(path) {
+        const response = await fetch(`${this.baseUrl}${path}`, {
+            method: 'DELETE',
+            headers: this.headers,
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`API DELETE ${path} failed: ${response.status} - ${text}`);
+        }
+    }
+}
+//# sourceMappingURL=api-client.js.map

package/dist/api-client.js.map

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

package/dist/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/cli.d.ts.map

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

package/dist/cli.js

@@ -0,0 +1,25 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ApiClient } from './api-client.js';
+import { createMcpServer } from './server.js';
+async function main() {
+    const apiUrl = process.env.AGENT_UI_API_URL;
+    if (!apiUrl) {
+        console.error('AGENT_UI_API_URL environment variable is required');
+        process.exit(1);
+    }
+    const client = new ApiClient({
+        baseUrl: apiUrl,
+        apiKey: process.env.AGENT_UI_API_KEY,
+    });
+    const server = createMcpServer(client, {
+        baseUrl: process.env.AGENT_UI_BASE_URL,
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error('MCP Server error:', err);
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAE9C,KAAK,UAAU,IAAI;IAClB,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAC5C,IAAI,CAAC,MAAM,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,mDAAmD,CAAC,CAAC;QACnE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACjB,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC5B,OAAO,EAAE,MAAM;QACf,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;KACpC,CAAC,CAAC;IAEH,MAAM,MAAM,GAAG,eAAe,CAAC,MAAM,EAAE;QACtC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB;KACtC,CAAC,CAAC;IACH,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;AACjC,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACpB,OAAO,CAAC,KAAK,CAAC,mBAAmB,EAAE,GAAG,CAAC,CAAC;IACxC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACjB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { ApiClient } from './api-client.js';
+export type { ApiClientOptions } from './api-client.js';
+export { createMcpServer } from './server.js';
+export type { McpServerOptions } from './server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,YAAY,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAC9C,YAAY,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+export { ApiClient } from './api-client.js';
+export { createMcpServer } from './server.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAE5C,OAAO,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,8 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { ApiClient } from './api-client.js';
+export interface McpServerOptions {
+    /** Base URL for page links (e.g. "https://example.com"). If set, full URLs are included in responses. */
+    baseUrl?: string;
+}
+export declare function createMcpServer(client: ApiClient, options?: McpServerOptions): McpServer;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEpE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAEjD,MAAM,WAAW,gBAAgB;IAChC,yGAAyG;IACzG,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,wBAAgB,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAyNxF"}

package/dist/server.js

@@ -0,0 +1,143 @@
+import { PageSpecSchema, validatePageSpec } from '@viyv/agent-ui-schema';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+export function createMcpServer(client, options) {
+    const server = new McpServer({
+        name: 'agent-ui',
+        version: '0.1.0',
+    });
+    const baseUrl = options?.baseUrl?.replace(/\/+$/, '');
+    function pageUrl(pageId) {
+        return baseUrl ? `${baseUrl}/pages/${pageId}` : `/pages/${pageId}`;
+    }
+    function previewUrl(previewId) {
+        return baseUrl ? `${baseUrl}/preview/${previewId}` : `/preview/${previewId}`;
+    }
+    // ── Catalog tools ──
+    server.tool('list_components', 'List all available UI component types with descriptions. Optionally filter by category.', { category: z.string().optional().describe('Filter by category (e.g. "input", "layout", "display", "data", "chart", "navigation", "overlay")') }, async ({ category }) => {
+        const query = category ? `?category=${encodeURIComponent(category)}` : '';
+        const data = await client.get(`/catalog/components${query}`);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool('get_component', 'Get detailed info about a component type, including all available props with their types and defaults.', { type: z.string().describe('Component type name (e.g. "DataTable", "Button", "Dialog")') }, async ({ type }) => {
+        const data = await client.get(`/catalog/components/${encodeURIComponent(type)}`);
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    server.tool('get_schema_guide', 'Get a comprehensive guide to PageSpec schema: all hook types, action types, expression syntax, theming options, and component overview.', {}, async () => {
+        const data = await client.get('/catalog/guide');
+        return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+    });
+    // ── Page management tools ──
+    server.tool('list_pages', 'List all saved pages.', {}, async () => {
+        const pages = await client.get('/pages');
+        if (baseUrl && Array.isArray(pages)) {
+            for (const page of pages) {
+                if (typeof page.id === 'string') {
+                    page.url = pageUrl(page.id);
+                }
+            }
+        }
+        return { content: [{ type: 'text', text: JSON.stringify(pages, null, 2) }] };
+    });
+    server.tool('get_page', 'Get the full PageSpec of a saved page.', { pageId: z.string().describe('The page ID to retrieve') }, async ({ pageId }) => {
+        const spec = await client.get(`/pages/${pageId}`);
+        const urlLine = baseUrl ? `\nURL: ${pageUrl(pageId)}` : '';
+        return {
+            content: [{ type: 'text', text: `${JSON.stringify(spec, null, 2)}${urlLine}` }],
+        };
+    });
+    server.tool('save_page', 'Save a page spec permanently. The page will be accessible at /pages/{id}.', {
+        spec: z.record(z.unknown()).describe('The PageSpec JSON object'),
+    }, async ({ spec }) => {
+        const result = await client.post('/pages', spec);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Page saved successfully!\n\nPage ID: ${result.id}\nCreated at: ${result.createdAt}\nURL: ${pageUrl(result.id)}`,
+                },
+            ],
+        };
+    });
+    server.tool('update_page', 'Update an existing page spec.', {
+        pageId: z.string().describe('The page ID to update'),
+        spec: z.record(z.unknown()).describe('The updated PageSpec JSON object'),
+    }, async ({ pageId, spec }) => {
+        const result = await client.put(`/pages/${pageId}`, spec);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Page updated!\n\nPage ID: ${result.id}\nUpdated at: ${result.updatedAt}\nURL: ${pageUrl(result.id)}`,
+                },
+            ],
+        };
+    });
+    server.tool('delete_page', 'Delete a saved page.', { pageId: z.string().describe('The page ID to delete') }, async ({ pageId }) => {
+        await client.delete(`/pages/${pageId}`);
+        return { content: [{ type: 'text', text: `Page "${pageId}" deleted.` }] };
+    });
+    server.tool('preview_page', 'Create a temporary preview of a page spec. Returns a preview URL for the user to review.', {
+        spec: z.record(z.unknown()).describe('The PageSpec JSON object'),
+    }, async ({ spec }) => {
+        const result = await client.post('/pages/preview', spec);
+        const url = previewUrl(result.previewId);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Preview created!\n\nPreview URL: ${url}\nExpires at: ${result.expiresAt}\n\nPlease ask the user to open this URL in their browser to review the page.`,
+                },
+            ],
+        };
+    });
+    server.tool('validate_page', 'Validate a PageSpec JSON object without saving it. Returns schema and semantic validation results.', {
+        spec: z.record(z.unknown()).describe('The PageSpec JSON object to validate'),
+    }, async ({ spec }) => {
+        // 1. Schema validation
+        const parsed = PageSpecSchema.safeParse(spec);
+        if (!parsed.success) {
+            const issues = parsed.error.issues.map((i) => `  - ${i.path.join('.')}: ${i.message}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Validation FAILED (schema errors):\n${issues.join('\n')}`,
+                    },
+                ],
+            };
+        }
+        // 2. Semantic validation
+        const result = validatePageSpec(parsed.data);
+        if (!result.valid) {
+            const errorLines = result.errors.map((e) => `  - [${e.severity}] ${e.path}: ${e.message}`);
+            const warningLines = result.warnings.map((w) => `  - [warning] ${w.path}: ${w.message}`);
+            const lines = [...errorLines, ...warningLines];
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Validation FAILED:\n${lines.join('\n')}`,
+                    },
+                ],
+            };
+        }
+        // 3. Success
+        if (result.warnings.length > 0) {
+            const warningLines = result.warnings.map((w) => `  - ${w.path}: ${w.message}`);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Validation PASSED with warnings:\n${warningLines.join('\n')}`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [{ type: 'text', text: 'Validation PASSED' }],
+        };
+    });
+    return server;
+}
+//# 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/package.json

@@ -0,0 +1,32 @@
+{
+	"name": "@viyv/agent-ui-mcp",
+	"version": "0.1.0",
+	"type": "module",
+	"main": "dist/index.js",
+	"types": "dist/index.d.ts",
+	"bin": {
+		"agent-ui-mcp": "dist/cli.js"
+	},
+	"exports": {
+		".": {
+			"development": "./src/index.ts",
+			"import": "./dist/index.js",
+			"types": "./dist/index.d.ts"
+		}
+	},
+	"scripts": {
+		"build": "tsc",
+		"typecheck": "tsc --noEmit",
+		"test": "vitest run",
+		"clean": "rm -rf dist"
+	},
+	"dependencies": {
+		"@viyv/agent-ui-schema": "^0.1.0",
+		"@modelcontextprotocol/sdk": "^1.12.1",
+		"zod": "^3.24.0"
+	},
+	"devDependencies": {
+		"typescript": "^5.7.0",
+		"vitest": "^2.1.0"
+	}
+}

package/src/__tests__/api-client.test.ts

@@ -0,0 +1,83 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest';
+import { ApiClient } from '../api-client.js';
+
+describe('ApiClient', () => {
+	beforeEach(() => {
+		vi.restoreAllMocks();
+	});
+
+	it('sends GET requests', async () => {
+		const mockResponse = { ok: true, json: () => Promise.resolve([{ id: 'test' }]) };
+		vi.spyOn(globalThis, 'fetch').mockResolvedValue(mockResponse as Response);
+
+		const client = new ApiClient({ baseUrl: 'http://localhost:3000/api/agent-ui' });
+		const result = await client.get('/pages');
+
+		expect(fetch).toHaveBeenCalledWith(
+			'http://localhost:3000/api/agent-ui/pages',
+			expect.objectContaining({ method: 'GET' }),
+		);
+		expect(result).toEqual([{ id: 'test' }]);
+	});
+
+	it('sends POST requests with body', async () => {
+		const mockResponse = { ok: true, json: () => Promise.resolve({ id: 'new' }) };
+		vi.spyOn(globalThis, 'fetch').mockResolvedValue(mockResponse as Response);
+
+		const client = new ApiClient({ baseUrl: 'http://localhost:3000/api/agent-ui' });
+		await client.post('/pages', { title: 'Test' });
+
+		expect(fetch).toHaveBeenCalledWith(
+			'http://localhost:3000/api/agent-ui/pages',
+			expect.objectContaining({
+				method: 'POST',
+				body: JSON.stringify({ title: 'Test' }),
+			}),
+		);
+	});
+
+	it('includes API key in Authorization header', async () => {
+		const mockResponse = { ok: true, json: () => Promise.resolve({}) };
+		vi.spyOn(globalThis, 'fetch').mockResolvedValue(mockResponse as Response);
+
+		const client = new ApiClient({
+			baseUrl: 'http://localhost:3000/api/agent-ui',
+			apiKey: 'test-key',
+		});
+		await client.get('/pages');
+
+		expect(fetch).toHaveBeenCalledWith(
+			expect.any(String),
+			expect.objectContaining({
+				headers: expect.objectContaining({
+					Authorization: 'Bearer test-key',
+				}),
+			}),
+		);
+	});
+
+	it('throws on non-OK response', async () => {
+		const mockResponse = {
+			ok: false,
+			status: 404,
+			text: () => Promise.resolve('Not found'),
+		};
+		vi.spyOn(globalThis, 'fetch').mockResolvedValue(mockResponse as Response);
+
+		const client = new ApiClient({ baseUrl: 'http://localhost:3000/api/agent-ui' });
+		await expect(client.get('/pages/missing')).rejects.toThrow('404');
+	});
+
+	it('sends DELETE requests', async () => {
+		const mockResponse = { ok: true };
+		vi.spyOn(globalThis, 'fetch').mockResolvedValue(mockResponse as Response);
+
+		const client = new ApiClient({ baseUrl: 'http://localhost:3000/api/agent-ui' });
+		await client.delete('/pages/test');
+
+		expect(fetch).toHaveBeenCalledWith(
+			'http://localhost:3000/api/agent-ui/pages/test',
+			expect.objectContaining({ method: 'DELETE' }),
+		);
+	});
+});

package/src/__tests__/tools.test.ts

@@ -0,0 +1,12 @@
+import { describe, expect, it } from 'vitest';
+import { ApiClient } from '../api-client.js';
+import { createMcpServer } from '../server.js';
+
+// Test the MCP server tools by verifying the server is created correctly
+describe('MCP Server', () => {
+	it('creates a server with correct name and version', () => {
+		const client = new ApiClient({ baseUrl: 'http://localhost:3000/api/agent-ui' });
+		const server = createMcpServer(client);
+		expect(server).toBeDefined();
+	});
+});

package/src/api-client.ts

@@ -0,0 +1,68 @@
+export interface ApiClientOptions {
+	baseUrl: string;
+	apiKey?: string;
+}
+
+export class ApiClient {
+	private baseUrl: string;
+	private headers: Record<string, string>;
+
+	constructor(options: ApiClientOptions) {
+		this.baseUrl = options.baseUrl.replace(/\/$/, '');
+		this.headers = {
+			'Content-Type': 'application/json',
+		};
+		if (options.apiKey) {
+			this.headers.Authorization = `Bearer ${options.apiKey}`;
+		}
+	}
+
+	async get<T = unknown>(path: string): Promise<T> {
+		const response = await fetch(`${this.baseUrl}${path}`, {
+			method: 'GET',
+			headers: this.headers,
+		});
+		if (!response.ok) {
+			const body = await response.text();
+			throw new Error(`API GET ${path} failed: ${response.status} - ${body}`);
+		}
+		return response.json() as Promise<T>;
+	}
+
+	async post<T = unknown>(path: string, body?: unknown): Promise<T> {
+		const response = await fetch(`${this.baseUrl}${path}`, {
+			method: 'POST',
+			headers: this.headers,
+			body: body !== undefined ? JSON.stringify(body) : undefined,
+		});
+		if (!response.ok) {
+			const text = await response.text();
+			throw new Error(`API POST ${path} failed: ${response.status} - ${text}`);
+		}
+		return response.json() as Promise<T>;
+	}
+
+	async put<T = unknown>(path: string, body: unknown): Promise<T> {
+		const response = await fetch(`${this.baseUrl}${path}`, {
+			method: 'PUT',
+			headers: this.headers,
+			body: JSON.stringify(body),
+		});
+		if (!response.ok) {
+			const text = await response.text();
+			throw new Error(`API PUT ${path} failed: ${response.status} - ${text}`);
+		}
+		return response.json() as Promise<T>;
+	}
+
+	async delete(path: string): Promise<void> {
+		const response = await fetch(`${this.baseUrl}${path}`, {
+			method: 'DELETE',
+			headers: this.headers,
+		});
+		if (!response.ok) {
+			const text = await response.text();
+			throw new Error(`API DELETE ${path} failed: ${response.status} - ${text}`);
+		}
+	}
+}

package/src/cli.ts

@@ -0,0 +1,28 @@
+#!/usr/bin/env node
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { ApiClient } from './api-client.js';
+import { createMcpServer } from './server.js';
+
+async function main() {
+	const apiUrl = process.env.AGENT_UI_API_URL;
+	if (!apiUrl) {
+		console.error('AGENT_UI_API_URL environment variable is required');
+		process.exit(1);
+	}
+
+	const client = new ApiClient({
+		baseUrl: apiUrl,
+		apiKey: process.env.AGENT_UI_API_KEY,
+	});
+
+	const server = createMcpServer(client, {
+		baseUrl: process.env.AGENT_UI_BASE_URL,
+	});
+	const transport = new StdioServerTransport();
+	await server.connect(transport);
+}
+
+main().catch((err) => {
+	console.error('MCP Server error:', err);
+	process.exit(1);
+});

package/src/index.ts

@@ -0,0 +1,4 @@
+export { ApiClient } from './api-client.js';
+export type { ApiClientOptions } from './api-client.js';
+export { createMcpServer } from './server.js';
+export type { McpServerOptions } from './server.js';

package/src/server.ts

@@ -0,0 +1,228 @@
+import { PageSpecSchema, validatePageSpec } from '@viyv/agent-ui-schema';
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import type { ApiClient } from './api-client.js';
+
+export interface McpServerOptions {
+	/** Base URL for page links (e.g. "https://example.com"). If set, full URLs are included in responses. */
+	baseUrl?: string;
+}
+
+export function createMcpServer(client: ApiClient, options?: McpServerOptions): McpServer {
+	const server = new McpServer({
+		name: 'agent-ui',
+		version: '0.1.0',
+	});
+
+	const baseUrl = options?.baseUrl?.replace(/\/+$/, '');
+
+	function pageUrl(pageId: string): string {
+		return baseUrl ? `${baseUrl}/pages/${pageId}` : `/pages/${pageId}`;
+	}
+
+	function previewUrl(previewId: string): string {
+		return baseUrl ? `${baseUrl}/preview/${previewId}` : `/preview/${previewId}`;
+	}
+
+	// ── Catalog tools ──
+
+	server.tool(
+		'list_components',
+		'List all available UI component types with descriptions. Optionally filter by category.',
+		{ category: z.string().optional().describe('Filter by category (e.g. "input", "layout", "display", "data", "chart", "navigation", "overlay")') },
+		async ({ category }) => {
+			const query = category ? `?category=${encodeURIComponent(category)}` : '';
+			const data = await client.get(`/catalog/components${query}`);
+			return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+		},
+	);
+
+	server.tool(
+		'get_component',
+		'Get detailed info about a component type, including all available props with their types and defaults.',
+		{ type: z.string().describe('Component type name (e.g. "DataTable", "Button", "Dialog")') },
+		async ({ type }) => {
+			const data = await client.get(`/catalog/components/${encodeURIComponent(type)}`);
+			return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+		},
+	);
+
+	server.tool(
+		'get_schema_guide',
+		'Get a comprehensive guide to PageSpec schema: all hook types, action types, expression syntax, theming options, and component overview.',
+		{},
+		async () => {
+			const data = await client.get('/catalog/guide');
+			return { content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] };
+		},
+	);
+
+	// ── Page management tools ──
+
+	server.tool('list_pages', 'List all saved pages.', {}, async () => {
+		const pages = await client.get<Array<Record<string, unknown>>>('/pages');
+		if (baseUrl && Array.isArray(pages)) {
+			for (const page of pages) {
+				if (typeof page.id === 'string') {
+					page.url = pageUrl(page.id);
+				}
+			}
+		}
+		return { content: [{ type: 'text', text: JSON.stringify(pages, null, 2) }] };
+	});
+
+	server.tool(
+		'get_page',
+		'Get the full PageSpec of a saved page.',
+		{ pageId: z.string().describe('The page ID to retrieve') },
+		async ({ pageId }) => {
+			const spec = await client.get(`/pages/${pageId}`);
+			const urlLine = baseUrl ? `\nURL: ${pageUrl(pageId)}` : '';
+			return {
+				content: [{ type: 'text', text: `${JSON.stringify(spec, null, 2)}${urlLine}` }],
+			};
+		},
+	);
+
+	server.tool(
+		'save_page',
+		'Save a page spec permanently. The page will be accessible at /pages/{id}.',
+		{
+			spec: z.record(z.unknown()).describe('The PageSpec JSON object'),
+		},
+		async ({ spec }) => {
+			const result = await client.post<{ id: string; createdAt: string }>('/pages', spec);
+			return {
+				content: [
+					{
+						type: 'text',
+						text: `Page saved successfully!\n\nPage ID: ${result.id}\nCreated at: ${result.createdAt}\nURL: ${pageUrl(result.id)}`,
+					},
+				],
+			};
+		},
+	);
+
+	server.tool(
+		'update_page',
+		'Update an existing page spec.',
+		{
+			pageId: z.string().describe('The page ID to update'),
+			spec: z.record(z.unknown()).describe('The updated PageSpec JSON object'),
+		},
+		async ({ pageId, spec }) => {
+			const result = await client.put<{ id: string; updatedAt: string }>(
+				`/pages/${pageId}`,
+				spec,
+			);
+			return {
+				content: [
+					{
+						type: 'text',
+						text: `Page updated!\n\nPage ID: ${result.id}\nUpdated at: ${result.updatedAt}\nURL: ${pageUrl(result.id)}`,
+					},
+				],
+			};
+		},
+	);
+
+	server.tool(
+		'delete_page',
+		'Delete a saved page.',
+		{ pageId: z.string().describe('The page ID to delete') },
+		async ({ pageId }) => {
+			await client.delete(`/pages/${pageId}`);
+			return { content: [{ type: 'text', text: `Page "${pageId}" deleted.` }] };
+		},
+	);
+
+	server.tool(
+		'preview_page',
+		'Create a temporary preview of a page spec. Returns a preview URL for the user to review.',
+		{
+			spec: z.record(z.unknown()).describe('The PageSpec JSON object'),
+		},
+		async ({ spec }) => {
+			const result = await client.post<{
+				previewId: string;
+				previewUrl: string;
+				expiresAt: string;
+			}>('/pages/preview', spec);
+			const url = previewUrl(result.previewId);
+			return {
+				content: [
+					{
+						type: 'text',
+						text: `Preview created!\n\nPreview URL: ${url}\nExpires at: ${result.expiresAt}\n\nPlease ask the user to open this URL in their browser to review the page.`,
+					},
+				],
+			};
+		},
+	);
+
+	server.tool(
+		'validate_page',
+		'Validate a PageSpec JSON object without saving it. Returns schema and semantic validation results.',
+		{
+			spec: z.record(z.unknown()).describe('The PageSpec JSON object to validate'),
+		},
+		async ({ spec }) => {
+			// 1. Schema validation
+			const parsed = PageSpecSchema.safeParse(spec);
+			if (!parsed.success) {
+				const issues = parsed.error.issues.map(
+					(i) => `  - ${i.path.join('.')}: ${i.message}`,
+				);
+				return {
+					content: [
+						{
+							type: 'text',
+							text: `Validation FAILED (schema errors):\n${issues.join('\n')}`,
+						},
+					],
+				};
+			}
+
+			// 2. Semantic validation
+			const result = validatePageSpec(parsed.data);
+			if (!result.valid) {
+				const errorLines = result.errors.map(
+					(e) => `  - [${e.severity}] ${e.path}: ${e.message}`,
+				);
+				const warningLines = result.warnings.map(
+					(w) => `  - [warning] ${w.path}: ${w.message}`,
+				);
+				const lines = [...errorLines, ...warningLines];
+				return {
+					content: [
+						{
+							type: 'text',
+							text: `Validation FAILED:\n${lines.join('\n')}`,
+						},
+					],
+				};
+			}
+
+			// 3. Success
+			if (result.warnings.length > 0) {
+				const warningLines = result.warnings.map(
+					(w) => `  - ${w.path}: ${w.message}`,
+				);
+				return {
+					content: [
+						{
+							type: 'text',
+							text: `Validation PASSED with warnings:\n${warningLines.join('\n')}`,
+						},
+					],
+				};
+			}
+
+			return {
+				content: [{ type: 'text', text: 'Validation PASSED' }],
+			};
+		},
+	);
+
+	return server;
+}

package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+	"extends": "../../tsconfig.base.json",
+	"compilerOptions": {
+		"outDir": "dist",
+		"rootDir": "src"
+	},
+	"include": ["src"]
+}