@kywi-software/mcp 0.1.0

package/dist/site/tools/users.d.ts

@@ -0,0 +1,60 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { KywiSdkScope } from '@kywi-software/sdk';
+export declare function handleListUsers(sdk: KywiSdkScope, args: {
+    siteId?: string | undefined;
+    role?: string | undefined;
+    limit?: number | undefined;
+    page?: number | undefined;
+}): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+}>;
+export declare function handleCreateUser(sdk: KywiSdkScope, args: {
+    email: string;
+    name: string;
+    role: string;
+    siteId: string;
+    password?: string | undefined;
+}): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+}>;
+export declare function handleGetSiteConfig(sdk: KywiSdkScope, args: {
+    siteId: string;
+}): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+} | {
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError: true;
+}>;
+export declare function handleUpdateSiteConfig(sdk: KywiSdkScope, args: {
+    siteId: string;
+    settings: Record<string, unknown>;
+}): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+} | {
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError: true;
+}>;
+export declare function registerUserTools(server: McpServer, sdk: KywiSdkScope): void;
+//# sourceMappingURL=users.d.ts.map

package/dist/site/tools/users.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"users.d.ts","sourceRoot":"","sources":["../../../src/site/tools/users.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAA;AAKtD,wBAAsB,eAAe,CACnC,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;IAAE,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE;;;;;;GASxH;AAED,wBAAsB,gBAAgB,CACpC,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE;;;;;;GAUnG;AAED,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAA;CAAE;;;;;;;;;;;;GAIzB;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,YAAY,EACjB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE;;;;;;;;;;;;GAQ5D;AAID,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,GAAG,IAAI,CAoC5E"}

package/dist/site/tools/users.js

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+import { textResult, errorResult } from '../../shared.js';
+// ─── Exported handler functions (testable without server) ───────────────────
+export async function handleListUsers(sdk, args) {
+    const result = await sdk.user.list({
+        siteId: args.siteId,
+        role: args.role,
+        limit: args.limit,
+        page: args.page,
+    });
+    return textResult(result);
+}
+export async function handleCreateUser(sdk, args) {
+    const user = await sdk.user.create({
+        email: args.email,
+        password: args.password ?? crypto.randomUUID(),
+        name: args.name,
+        role: args.role,
+        siteId: args.siteId,
+    });
+    return textResult(user);
+}
+export async function handleGetSiteConfig(sdk, args) {
+    const config = await sdk.site.getConfig(args.siteId);
+    return config ? textResult(config) : errorResult('Site config not found');
+}
+export async function handleUpdateSiteConfig(sdk, args) {
+    try {
+        const settings = await sdk.site.updateSettings(args.siteId, args.settings);
+        return textResult({ updated: true, siteId: args.siteId, settings });
+    }
+    catch (e) {
+        return errorResult(e instanceof Error ? e.message : 'Failed to update site config');
+    }
+}
+// ─── Registration ───────────────────────────────────────────────────────────
+export function registerUserTools(server, sdk) {
+    server.registerTool('list_users', {
+        description: 'List users for a site (requires siteAdmin role)',
+        inputSchema: {
+            siteId: z.string().optional().describe('Filter by site ID'),
+            role: z.string().optional().describe('Filter by role'),
+            limit: z.number().optional().describe('Items per page'),
+            page: z.number().optional().describe('Page number'),
+        },
+    }, async (args) => handleListUsers(sdk, args));
+    server.registerTool('create_user', {
+        description: 'Create a user account (requires siteAdmin role)',
+        inputSchema: {
+            email: z.string().describe('User email'),
+            name: z.string().describe('User display name'),
+            role: z.string().describe('User role'),
+            siteId: z.string().describe('Site ID'),
+            password: z.string().optional().describe('Initial password (auto-generated if omitted)'),
+        },
+    }, async (args) => handleCreateUser(sdk, args));
+    server.registerTool('get_site_config', {
+        description: 'Get site configuration',
+        inputSchema: {
+            siteId: z.string().describe('Site ID'),
+        },
+    }, async (args) => handleGetSiteConfig(sdk, args));
+    server.registerTool('update_site_config', {
+        description: 'Update a site’s settings (bulk key/value upsert; requires siteAdmin role)',
+        inputSchema: {
+            siteId: z.string().describe('Site ID'),
+            settings: z.record(z.unknown()).describe('Settings to upsert (merged into existing settings)'),
+        },
+    }, async (args) => handleUpdateSiteConfig(sdk, args));
+}
+//# sourceMappingURL=users.js.map

package/dist/site/tools/users.js.map

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

package/dist/site/tools/webhooks.d.ts

@@ -0,0 +1,34 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import type { KywiHttpClient } from '@kywi-software/sdk';
+export declare function handleCreateWebhook(http: KywiHttpClient, args: {
+    url: string;
+    events: string[];
+    secret?: string | undefined;
+}): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+} | {
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError: true;
+}>;
+export declare function handleListWebhooks(http: KywiHttpClient): Promise<{
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError?: undefined;
+} | {
+    content: [{
+        type: "text";
+        text: string;
+    }];
+    isError: true;
+}>;
+export declare function registerWebhookTools(server: McpServer, http: KywiHttpClient): void;
+//# sourceMappingURL=webhooks.d.ts.map

package/dist/site/tools/webhooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.d.ts","sourceRoot":"","sources":["../../../src/site/tools/webhooks.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAA;AACxE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAA;AAKxD,wBAAsB,mBAAmB,CACvC,IAAI,EAAE,cAAc,EACpB,IAAI,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,EAAE,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE;;;;;;;;;;;;GAerE;AAED,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,cAAc;;;;;;;;;;;;GAO5D;AAID,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,GAAG,IAAI,CAclF"}

package/dist/site/tools/webhooks.js

@@ -0,0 +1,44 @@
+import { z } from 'zod';
+import { textResult, errorResult } from '../../shared.js';
+// ─── Exported handler functions (testable without server) ─────────────────
+export async function handleCreateWebhook(http, args) {
+    try {
+        const payload = {
+            url: args.url,
+            events: args.events,
+        };
+        if (args.secret) {
+            payload.secret = args.secret;
+        }
+        const result = await http.post('/webhooks', payload);
+        return textResult(result);
+    }
+    catch (err) {
+        return errorResult(`Failed to create webhook: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+export async function handleListWebhooks(http) {
+    try {
+        const result = await http.get('/webhooks');
+        return textResult(result);
+    }
+    catch (err) {
+        return errorResult(`Failed to list webhooks: ${err instanceof Error ? err.message : String(err)}`);
+    }
+}
+// ─── Registration ─────────────────────────────────────────────────────────────
+export function registerWebhookTools(server, http) {
+    server.registerTool('create_webhook', {
+        description: 'Create a webhook that fires on content events',
+        inputSchema: {
+            url: z.string().url().describe('Webhook endpoint URL'),
+            events: z.array(z.string()).describe('Events to subscribe to (e.g. content.published, content.updated)'),
+            secret: z.string().optional().describe('Optional shared secret for HMAC signature verification'),
+        },
+    }, async (args) => handleCreateWebhook(http, args));
+    server.registerTool('list_webhooks', {
+        description: 'List all configured webhooks',
+        inputSchema: {},
+    }, async () => handleListWebhooks(http));
+}
+//# sourceMappingURL=webhooks.js.map

package/dist/site/tools/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../../src/site/tools/webhooks.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAA;AAGvB,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,iBAAiB,CAAA;AAEzD,6EAA6E;AAE7E,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,IAAoB,EACpB,IAAoE;IAEpE,IAAI,CAAC;QACH,MAAM,OAAO,GAA4B;YACvC,GAAG,EAAE,IAAI,CAAC,GAAG;YACb,MAAM,EAAE,IAAI,CAAC,MAAM;SACpB,CAAA;QACD,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAA;QAC9B,CAAC;QACD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAU,WAAW,EAAE,OAAO,CAAC,CAAA;QAC7D,OAAO,UAAU,CAAC,MAAM,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,6BAA6B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACrG,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kBAAkB,CAAC,IAAoB;IAC3D,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,GAAG,CAAU,WAAW,CAAC,CAAA;QACnD,OAAO,UAAU,CAAC,MAAM,CAAC,CAAA;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,WAAW,CAAC,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAA;IACpG,CAAC;AACH,CAAC;AAED,iFAAiF;AAEjF,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,IAAoB;IAC1E,MAAM,CAAC,YAAY,CAAC,gBAAgB,EAAE;QACpC,WAAW,EAAE,+CAA+C;QAC5D,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC;YACtD,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,CAAC,kEAAkE,CAAC;YACxG,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,wDAAwD,CAAC;SACjG;KACF,EAAE,KAAK,EAAE,IAAI,EAAE,EAAE,CAAC,mBAAmB,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,CAAA;IAEnD,MAAM,CAAC,YAAY,CAAC,eAAe,EAAE;QACnC,WAAW,EAAE,8BAA8B;QAC3C,WAAW,EAAE,EAAE;KAChB,EAAE,KAAK,IAAI,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAA;AAC1C,CAAC"}

package/package.json

@@ -0,0 +1,61 @@
+{
+  "name": "@kywi-software/mcp",
+  "version": "0.1.0",
+  "description": "Model Context Protocol servers for Kywi CMS — a site server (content/nav/media over the REST API) and a developer server (kywi.config.ts scaffolding and mutation).",
+  "type": "module",
+  "license": "AGPL-3.0-only",
+  "homepage": "https://github.com/Kywi-Software/kywi-cms#readme",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Kywi-Software/kywi-cms.git",
+    "directory": "packages/mcp"
+  },
+  "keywords": [
+    "kywi",
+    "cms",
+    "mcp",
+    "model-context-protocol",
+    "ai-agent"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    },
+    "./site": {
+      "types": "./dist/site/index.d.ts",
+      "import": "./dist/site/index.js"
+    },
+    "./developer": {
+      "types": "./dist/developer/index.d.ts",
+      "import": "./dist/developer/index.js"
+    }
+  },
+  "bin": {
+    "kywi-mcp-site": "./dist/site/cli.js",
+    "kywi-mcp-dev": "./dist/developer/cli.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.25.0",
+    "@kywi-software/sdk": "0.1.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.5.0",
+    "vitest": "^1.6.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  }
+}