@thierry-gilgen-ict/engawa-mcp 0.1.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Thierry Gilgen ICT
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,7 @@
+# @thierry-gilgen-ict/engawa-mcp
+
+Generic MCP adapter for Engawa using `@modelcontextprotocol/server` v2 (MCP spec 2026-07-28).
+
+**Public v0.1 API:** `createEngawaPublicMcpServer()` and `createEngawaPublicMcpHandler()` — require `agentInterface.enabled` and `agentInterface.public`. Private or authenticated MCP is a future, separate surface.
+
+Exposes registered content as MCP resources and a bounded read-only `search_site` tool with limits from `EngawaConfig`.

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+import { McpServer } from "@modelcontextprotocol/server";
+import { type Engawa, type EngawaConfig } from "@thierry-gilgen-ict/engawa-core";
+export declare class EngawaAgentInterfaceError extends Error {
+    constructor(message: string);
+}
+export declare function assertPublicAgentInterface(config: EngawaConfig): void;
+export declare function createEngawaPublicMcpServer(engawa: Engawa): Promise<McpServer>;
+export declare function createEngawaPublicMcpHandler(engawa: Engawa): import("@modelcontextprotocol/server").McpHttpHandler;
+//# 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,EAAoB,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EAEL,KAAK,MAAM,EACX,KAAK,YAAY,EAElB,MAAM,iCAAiC,CAAC;AAKzC,qBAAa,yBAA0B,SAAQ,KAAK;gBACtC,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,YAAY,GAAG,IAAI,CASrE;AAkID,wBAAsB,2BAA2B,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC,CAGpF;AAED,wBAAgB,4BAA4B,CAAC,MAAM,EAAE,MAAM,yDAG1D"}

package/dist/index.js

@@ -0,0 +1,128 @@
+import { createMcpHandler, McpServer } from "@modelcontextprotocol/server";
+import { buildResourceUri, } from "@thierry-gilgen-ict/engawa-core";
+import * as z from "zod/v4";
+const META_RESOURCE_ID = "_meta";
+export class EngawaAgentInterfaceError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "EngawaAgentInterfaceError";
+    }
+}
+export function assertPublicAgentInterface(config) {
+    if (!config.agentInterface.enabled) {
+        throw new EngawaAgentInterfaceError("Agent interface is disabled");
+    }
+    if (!config.agentInterface.public) {
+        throw new EngawaAgentInterfaceError("Public agent interface is not enabled for this configuration");
+    }
+}
+const searchResultSchema = z.object({
+    results: z.array(z.object({
+        uri: z.string(),
+        title: z.string(),
+        description: z.string().optional(),
+        canonicalUrl: z.string(),
+    })),
+});
+function buildSearchInputSchema(config) {
+    const maxQuery = config.content.maxSearchQueryLength;
+    const maxResults = config.content.maxSearchResults;
+    return z.object({
+        query: z
+            .string()
+            .min(1)
+            .max(maxQuery)
+            .describe(`Search query for site content (max ${maxQuery} characters)`),
+        limit: z
+            .number()
+            .int()
+            .min(1)
+            .max(maxResults)
+            .optional()
+            .describe(`Maximum number of results (default ${maxResults}, max ${maxResults})`),
+    });
+}
+async function createEngawaMcpServerInternal(engawa) {
+    const server = new McpServer({
+        name: "engawa",
+        version: engawa.metadata.engawaVersion,
+    });
+    const metaUri = buildResourceUri(engawa.config.site.canonicalUrl, META_RESOURCE_ID);
+    server.registerResource("engawa-meta", metaUri, {
+        title: "Engawa agent interface metadata",
+        description: "Version and implementation profile for this Engawa endpoint",
+        mimeType: "application/json",
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: "application/json",
+                text: JSON.stringify({
+                    engawaVersion: engawa.metadata.engawaVersion,
+                    implementationProfile: engawa.metadata.implementationProfile,
+                    mcpProtocolBaseline: engawa.metadata.mcpProtocolBaseline,
+                    site: {
+                        name: engawa.config.site.name,
+                        canonicalUrl: engawa.config.site.canonicalUrl,
+                    },
+                    security: engawa.config.security,
+                }),
+            },
+        ],
+    }));
+    const resources = await engawa.listResources();
+    for (const resource of resources) {
+        registerEngawaResource(server, resource);
+    }
+    const searchInputSchema = buildSearchInputSchema(engawa.config);
+    const defaultLimit = engawa.config.content.maxSearchResults;
+    server.registerTool("search_site", {
+        title: "Search site content",
+        description: "Search public site content registered with Engawa (read-only)",
+        annotations: { readOnlyHint: true },
+        inputSchema: searchInputSchema,
+        outputSchema: searchResultSchema,
+    }, async ({ query, limit }) => {
+        const max = limit ?? defaultLimit;
+        const results = await engawa.search(query);
+        const bounded = results.slice(0, max).map(toSearchHit);
+        const output = { results: bounded };
+        return {
+            content: [{ type: "text", text: JSON.stringify(output) }],
+            structuredContent: output,
+        };
+    });
+    return server;
+}
+function registerEngawaResource(server, resource) {
+    server.registerResource(`resource-${resource.id}`, resource.uri, {
+        title: resource.title,
+        description: resource.description,
+        mimeType: resource.mimeType,
+    }, async (uri) => ({
+        contents: [
+            {
+                uri: uri.href,
+                mimeType: resource.mimeType,
+                text: resource.content,
+            },
+        ],
+    }));
+}
+function toSearchHit(resource) {
+    return {
+        uri: resource.uri,
+        title: resource.title,
+        description: resource.description,
+        canonicalUrl: resource.canonicalUrl,
+    };
+}
+export async function createEngawaPublicMcpServer(engawa) {
+    assertPublicAgentInterface(engawa.config);
+    return createEngawaMcpServerInternal(engawa);
+}
+export function createEngawaPublicMcpHandler(engawa) {
+    assertPublicAgentInterface(engawa.config);
+    return createMcpHandler(() => createEngawaPublicMcpServer(engawa));
+}
+//# 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,gBAAgB,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AAC3E,OAAO,EACL,gBAAgB,GAIjB,MAAM,iCAAiC,CAAC;AACzC,OAAO,KAAK,CAAC,MAAM,QAAQ,CAAC;AAE5B,MAAM,gBAAgB,GAAG,OAAO,CAAC;AAEjC,MAAM,OAAO,yBAA0B,SAAQ,KAAK;IAClD,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;IAC1C,CAAC;CACF;AAED,MAAM,UAAU,0BAA0B,CAAC,MAAoB;IAC7D,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,CAAC;QACnC,MAAM,IAAI,yBAAyB,CAAC,6BAA6B,CAAC,CAAC;IACrE,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,CAAC;QAClC,MAAM,IAAI,yBAAyB,CACjC,8DAA8D,CAC/D,CAAC;IACJ,CAAC;AACH,CAAC;AAED,MAAM,kBAAkB,GAAG,CAAC,CAAC,MAAM,CAAC;IAClC,OAAO,EAAE,CAAC,CAAC,KAAK,CACd,CAAC,CAAC,MAAM,CAAC;QACP,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE;QACf,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;QACjB,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAClC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE;KACzB,CAAC,CACH;CACF,CAAC,CAAC;AAEH,SAAS,sBAAsB,CAAC,MAAoB;IAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,oBAAoB,CAAC;IACrD,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC;IACnD,OAAO,CAAC,CAAC,MAAM,CAAC;QACd,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,QAAQ,CAAC;aACb,QAAQ,CAAC,sCAAsC,QAAQ,cAAc,CAAC;QACzE,KAAK,EAAE,CAAC;aACL,MAAM,EAAE;aACR,GAAG,EAAE;aACL,GAAG,CAAC,CAAC,CAAC;aACN,GAAG,CAAC,UAAU,CAAC;aACf,QAAQ,EAAE;aACV,QAAQ,CAAC,sCAAsC,UAAU,SAAS,UAAU,GAAG,CAAC;KACpF,CAAC,CAAC;AACL,CAAC;AAED,KAAK,UAAU,6BAA6B,CAAC,MAAc;IACzD,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;QAC3B,IAAI,EAAE,QAAQ;QACd,OAAO,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa;KACvC,CAAC,CAAC;IAEH,MAAM,OAAO,GAAG,gBAAgB,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,gBAAgB,CAAC,CAAC;IAEpF,MAAM,CAAC,gBAAgB,CACrB,aAAa,EACb,OAAO,EACP;QACE,KAAK,EAAE,iCAAiC;QACxC,WAAW,EAAE,6DAA6D;QAC1E,QAAQ,EAAE,kBAAkB;KAC7B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,QAAQ,EAAE,kBAAkB;gBAC5B,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC;oBACnB,aAAa,EAAE,MAAM,CAAC,QAAQ,CAAC,aAAa;oBAC5C,qBAAqB,EAAE,MAAM,CAAC,QAAQ,CAAC,qBAAqB;oBAC5D,mBAAmB,EAAE,MAAM,CAAC,QAAQ,CAAC,mBAAmB;oBACxD,IAAI,EAAE;wBACJ,IAAI,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI;wBAC7B,YAAY,EAAE,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,YAAY;qBAC9C;oBACD,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,QAAQ;iBACjC,CAAC;aACH;SACF;KACF,CAAC,CACH,CAAC;IAEF,MAAM,SAAS,GAAG,MAAM,MAAM,CAAC,aAAa,EAAE,CAAC;IAC/C,KAAK,MAAM,QAAQ,IAAI,SAAS,EAAE,CAAC;QACjC,sBAAsB,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IAC3C,CAAC;IAED,MAAM,iBAAiB,GAAG,sBAAsB,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC;IAE5D,MAAM,CAAC,YAAY,CACjB,aAAa,EACb;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,+DAA+D;QAC5E,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE;QACnC,WAAW,EAAE,iBAAiB;QAC9B,YAAY,EAAE,kBAAkB;KACjC,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE,EAAE;QACzB,MAAM,GAAG,GAAG,KAAK,IAAI,YAAY,CAAC;QAClC,MAAM,OAAO,GAAG,MAAM,MAAM,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QACvD,MAAM,MAAM,GAAG,EAAE,OAAO,EAAE,OAAO,EAAE,CAAC;QACpC,OAAO;YACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,CAAC;YAClE,iBAAiB,EAAE,MAAM;SAC1B,CAAC;IACJ,CAAC,CACF,CAAC;IAEF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,sBAAsB,CAAC,MAAiB,EAAE,QAAwB;IACzE,MAAM,CAAC,gBAAgB,CACrB,YAAY,QAAQ,CAAC,EAAE,EAAE,EACzB,QAAQ,CAAC,GAAG,EACZ;QACE,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,QAAQ,EAAE,QAAQ,CAAC,QAAQ;KAC5B,EACD,KAAK,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC;QACd,QAAQ,EAAE;YACR;gBACE,GAAG,EAAE,GAAG,CAAC,IAAI;gBACb,QAAQ,EAAE,QAAQ,CAAC,QAAQ;gBAC3B,IAAI,EAAE,QAAQ,CAAC,OAAO;aACvB;SACF;KACF,CAAC,CACH,CAAC;AACJ,CAAC;AAED,SAAS,WAAW,CAAC,QAAwB;IAC3C,OAAO;QACL,GAAG,EAAE,QAAQ,CAAC,GAAG;QACjB,KAAK,EAAE,QAAQ,CAAC,KAAK;QACrB,WAAW,EAAE,QAAQ,CAAC,WAAW;QACjC,YAAY,EAAE,QAAQ,CAAC,YAAY;KACpC,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,2BAA2B,CAAC,MAAc;IAC9D,0BAA0B,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,6BAA6B,CAAC,MAAM,CAAC,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,4BAA4B,CAAC,MAAc;IACzD,0BAA0B,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC1C,OAAO,gBAAgB,CAAC,GAAG,EAAE,CAAC,2BAA2B,CAAC,MAAM,CAAC,CAAC,CAAC;AACrE,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@thierry-gilgen-ict/engawa-mcp",
+  "version": "0.1.0",
+  "description": "MCP server adapter for Engawa agent-native websites",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/thierry-gilgen-ict/engawa.git",
+    "directory": "packages/mcp"
+  },
+  "bugs": {
+    "url": "https://github.com/thierry-gilgen-ict/engawa/issues"
+  },
+  "homepage": "https://github.com/thierry-gilgen-ict/engawa#readme",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@modelcontextprotocol/server": "2.0.0",
+    "@thierry-gilgen-ict/engawa-core": "0.1.0",
+    "zod": "^4.2.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}