eddyter-mcp 0.1.0

package/README.md

@@ -0,0 +1,94 @@
+# Eddyter MCP Server
+
+A [Model Context Protocol](https://modelcontextprotocol.io) server that lets AI
+tools (Claude Desktop, Cursor, Windsurf, …) inspect and — in later steps —
+configure the [Eddyter](https://www.eddyter.com) editor on an admin's behalf.
+
+This is the **admin-side** surface: the account owner connects it to their AI
+tool using a license key. Changes made through it apply to every end-user of the
+editor that uses that key, with no redeploy (config lives server-side on the key).
+
+## Tools
+
+Reads are always available. The config-changing tool is **opt-in**
+(`EDDYTER_ALLOW_WRITES=true`) so a pasted key can't change the live editor unless
+the admin allows it.
+
+| Tool | Mode | What it does |
+| --- | --- | --- |
+| `verify_status` | read | Is the key valid/active? Plan, expiry, subscription, BYOK, warnings. |
+| `get_config` | read | Which editor features are enabled, off-but-allowed, or locked by plan. |
+| `get_usage` | read | Credits remaining, usage this period, days until reset. |
+| `get_integration_snippet` | read | SSR-safe copy-paste setup code per framework. |
+| `update_config` | **write** (opt-in) | Patch the editor's features (e.g. turn AI chat off). Clamped to the plan; live with no redeploy. |
+
+Backend: reads ride the public `/api/license/validate`; `get_usage` and
+`update_config` use the X-API-Key endpoints `GET /api/license/usage` and
+`POST /api/license/config`.
+
+## Setup
+
+```bash
+pnpm install
+pnpm build
+```
+
+Get a license key from the dashboard: <https://www.eddyter.com/user/license-key>
+(The MCP never creates keys — humans mint them in the portal.)
+
+### Connect to Claude Desktop
+
+Add to `claude_desktop_config.json` (Settings → Developer → Edit Config):
+
+```json
+{
+  "mcpServers": {
+    "eddyter": {
+      "command": "node",
+      "args": ["/absolute/path/to/apps/mcp/dist/index.js"],
+      "env": {
+        "EDDYTER_LICENSE_KEY": "eddyt_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Connect to Cursor
+
+`.cursor/mcp.json` in your project, same `command` / `args` / `env` shape.
+
+Then ask the agent: *"Is my Eddyter key valid?"* or *"What editor features do I
+have enabled?"*
+
+## Configuration
+
+| Env var | Default | Purpose |
+| --- | --- | --- |
+| `EDDYTER_LICENSE_KEY` | — | Key the agent acts on. Optional if passed per tool call. |
+| `EDDYTER_ENV` | `production` | `production` \| `staging` \| `local`. |
+| `EDDYTER_API_BASE_URL` | — | Advanced override of the backend base URL. |
+| `EDDYTER_ALLOW_WRITES` | `false` | Set `true` to expose `update_config` (lets the agent change the live editor). |
+
+## Develop & test
+
+```bash
+pnpm dev          # tsc --watch
+pnpm inspect      # open the MCP Inspector against this server
+```
+
+Quick manual smoke test (no real key needed — exercises the live error path):
+
+```bash
+printf '%s\n' \
+  '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"t","version":"0"}}}' \
+  '{"jsonrpc":"2.0","method":"notifications/initialized"}' \
+  '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}' \
+  | node dist/index.js
+```
+
+## Notes
+
+- Logs go to **stderr** — stdout is the JSON-RPC channel and must stay clean.
+- Feature labels surfaced by `get_config` live in `src/format.ts`
+  (`FEATURE_LABELS`) — tune names/ordering there to match the marketing site.

package/dist/client.js

@@ -0,0 +1,107 @@
+/**
+ * Thin client over the Eddyter backend.
+ *
+ * Step 1 only needs the public, X-API-Key-authenticated validation endpoint —
+ * the same one the editor itself calls on mount. No new backend surface.
+ */
+export class EddyterError extends Error {
+    status;
+    code;
+    constructor(message, status, code) {
+        super(message);
+        this.status = status;
+        this.code = code;
+        this.name = "EddyterError";
+    }
+}
+export class EddyterClient {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    /**
+     * Resolve the license key for a tool call: explicit arg wins, otherwise the
+     * one configured in the MCP client. Throws a clear, actionable error if neither.
+     */
+    resolveLicenseKey(explicit) {
+        const key = explicit?.trim() || this.config.defaultLicenseKey;
+        if (!key) {
+            throw new EddyterError("No Eddyter license key provided. Set EDDYTER_LICENSE_KEY in your MCP client " +
+                "config, or pass `licenseKey` to the tool. Create a key at " +
+                "https://www.eddyter.com/user/license-key");
+        }
+        return key;
+    }
+    /** Authenticated request helper: attaches X-API-Key and unwraps {success,data}. */
+    async request(method, path, licenseKey, body) {
+        const url = `${this.config.baseUrl}${path}`;
+        let res;
+        try {
+            res = await fetch(url, {
+                method,
+                headers: {
+                    "Content-Type": "application/json",
+                    "X-API-Key": licenseKey,
+                },
+                body: body === undefined ? undefined : JSON.stringify(body),
+            });
+        }
+        catch (err) {
+            throw new EddyterError(`Could not reach Eddyter at ${url}: ${err.message}`);
+        }
+        let parsed;
+        try {
+            parsed = (await res.json());
+        }
+        catch {
+            // fall through to status-based error
+        }
+        if (!res.ok || !parsed?.success) {
+            throw new EddyterError(parsed?.message || `Request to ${path} failed (HTTP ${res.status})`, res.status, parsed?.code);
+        }
+        return parsed.data;
+    }
+    /** Calls POST /api/license/validate with the key in the X-API-Key header. */
+    async validate(licenseKey) {
+        const url = `${this.config.baseUrl}/api/license/validate`;
+        let res;
+        try {
+            res = await fetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "X-API-Key": licenseKey,
+                },
+                body: "{}",
+            });
+        }
+        catch (err) {
+            throw new EddyterError(`Could not reach Eddyter at ${url}: ${err.message}`);
+        }
+        let body;
+        try {
+            body = (await res.json());
+        }
+        catch {
+            // fall through to status-based error below
+        }
+        if (!res.ok || !body?.success) {
+            throw new EddyterError(body?.message || `License validation failed (HTTP ${res.status})`, res.status, body?.code);
+        }
+        return body;
+    }
+    /** GET /api/license/usage — credits, current-period usage, plan summary. */
+    async getUsage(licenseKey) {
+        return this.request("GET", "/api/license/usage", licenseKey);
+    }
+    /**
+     * POST /api/license/config — patch this key's editor config (clamped to plan).
+     * Returns the new effective config plus the plan ceiling.
+     */
+    async updateConfig(licenseKey, partialCustomizations) {
+        return this.request("POST", "/api/license/config", licenseKey, {
+            customizations: partialCustomizations,
+        });
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/config.js

@@ -0,0 +1,28 @@
+/**
+ * Resolves which Eddyter backend to talk to and the license key the agent
+ * acts on behalf of.
+ *
+ * Base URLs mirror apps/editor/src/config/env.ts so the MCP and the editor
+ * always agree on which environment a key belongs to.
+ */
+const ENV_BASE_URLS = {
+    production: "https://api.eddyter.com",
+    staging: "https://api.cteditor.com",
+    local: "http://localhost:3000",
+};
+function parseBool(value) {
+    if (!value)
+        return false;
+    return ["1", "true", "yes", "on"].includes(value.trim().toLowerCase());
+}
+export function loadConfig() {
+    const explicitBase = process.env.EDDYTER_API_BASE_URL?.trim();
+    const envName = (process.env.EDDYTER_ENV?.trim() || "production").toLowerCase();
+    const baseUrl = explicitBase || ENV_BASE_URLS[envName] || ENV_BASE_URLS.production;
+    return {
+        baseUrl: baseUrl.replace(/\/+$/, ""),
+        defaultLicenseKey: process.env.EDDYTER_LICENSE_KEY?.trim() || undefined,
+        allowWrites: parseBool(process.env.EDDYTER_ALLOW_WRITES),
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,aAAa,GAA2B;IAC5C,UAAU,EAAE,yBAAyB;IACrC,OAAO,EAAE,0BAA0B;IACnC,KAAK,EAAE,uBAAuB;CAC/B,CAAC;AAcF,SAAS,SAAS,CAAC,KAAyB;IAC1C,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,UAAU;IACxB,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,CAAC,oBAAoB,EAAE,IAAI,EAAE,CAAC;IAC9D,MAAM,OAAO,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;IAEhF,MAAM,OAAO,GACX,YAAY,IAAI,aAAa,CAAC,OAAO,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC;IAErE,OAAO;QACL,OAAO,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;QACpC,iBAAiB,EAAE,OAAO,CAAC,GAAG,CAAC,mBAAmB,EAAE,IAAI,EAAE,IAAI,SAAS;QACvE,WAAW,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC;KACzD,CAAC;AACJ,CAAC"}

package/dist/format.js

@@ -0,0 +1,110 @@
+/**
+ * Turns the raw `customizations` / `planCustomizations` payloads into something
+ * an AI agent (and the admin reading its reply) can reason about:
+ *
+ *   - enabled:  feature is ON for this key
+ *   - disabled: feature is OFF, but the plan allows turning it on
+ *   - locked:   the plan does not permit this feature (upsell, not a toggle)
+ *
+ * The classification logic is generic. The ONE thing worth tuning by hand is
+ * FEATURE_LABELS below: human-friendly names + which toggles are "primary"
+ * (surfaced first) vs. advanced. That's a product/UX call — see note at bottom.
+ */
+/**
+ * Human-facing labels for the toolbarOptions toggles in EditorConfigTypes.
+ * Keys not listed here still get reported, just with a derived label.
+ *
+ * 👉 TUNE ME: order ~= importance; trim/rename to match how you describe
+ * features on the marketing site and dashboard.
+ */
+const FEATURE_LABELS = {
+    enableAIChat: "AI Chat",
+    enableTextFormatting: "Text formatting (bold / italic / underline)",
+    enableTableOptions: "Tables",
+    enableImageUpload: "Image upload",
+    enableComments: "Comments",
+    enableMentions: "@mentions",
+    enableCharts: "Charts",
+    enableEmbeds: "Embeds (YouTube, Loom, …)",
+    enablePdfExport: "PDF export",
+    enableDocExport: "DOC export",
+    enableSpeechToText: "Speech to text",
+    enableHeadings: "Headings",
+    enableLists: "Lists",
+    enableColors: "Text & background colors",
+    enableNotePanels: "Callout / note panels",
+    enableTodoList: "To-do lists",
+    enableFormatPainter: "Format painter",
+};
+function deriveLabel(key) {
+    if (FEATURE_LABELS[key])
+        return FEATURE_LABELS[key];
+    // enableFooBar -> "Foo bar"
+    const stripped = key.replace(/^enable/, "");
+    const spaced = stripped.replace(/([A-Z])/g, " $1").trim();
+    return spaced.charAt(0).toUpperCase() + spaced.slice(1).toLowerCase();
+}
+function asBoolMap(obj) {
+    const out = {};
+    if (obj && typeof obj === "object") {
+        for (const [k, v] of Object.entries(obj)) {
+            if (typeof v === "boolean")
+                out[k] = v;
+        }
+    }
+    return out;
+}
+/**
+ * Classify each toolbar feature given the key's current config and the plan ceiling.
+ * A feature is `locked` when the plan explicitly disallows it (ceiling === false).
+ */
+export function summarizeFeatures(customizations, planCustomizations) {
+    const current = asBoolMap(customizations?.toolbarOptions);
+    const ceiling = asBoolMap(planCustomizations?.toolbarOptions);
+    const allKeys = new Set([...Object.keys(current), ...Object.keys(ceiling)]);
+    const summaries = [];
+    for (const key of allKeys) {
+        const allowedByPlan = ceiling[key] !== false; // absent or true => allowed
+        const onNow = current[key] === true;
+        let state;
+        if (!allowedByPlan)
+            state = "locked";
+        else if (onNow)
+            state = "enabled";
+        else
+            state = "disabled";
+        summaries.push({ key, label: deriveLabel(key), state });
+    }
+    // Primary features (those we have explicit labels for) first, in declared order.
+    const order = Object.keys(FEATURE_LABELS);
+    summaries.sort((a, b) => {
+        const ai = order.indexOf(a.key);
+        const bi = order.indexOf(b.key);
+        if (ai !== -1 && bi !== -1)
+            return ai - bi;
+        if (ai !== -1)
+            return -1;
+        if (bi !== -1)
+            return 1;
+        return a.label.localeCompare(b.label);
+    });
+    return summaries;
+}
+/** Compact, agent-readable text rendering of the feature summary. */
+export function renderFeatureSummary(summaries) {
+    const group = (state) => summaries
+        .filter((s) => s.state === state)
+        .map((s) => `  • ${s.label}`)
+        .join("\n") || "  (none)";
+    return [
+        "Enabled:",
+        group("enabled"),
+        "",
+        "Disabled (plan allows turning on):",
+        group("disabled"),
+        "",
+        "Locked by plan (upgrade to unlock):",
+        group("locked"),
+    ].join("\n");
+}
+//# sourceMappingURL=format.js.map

package/dist/format.js.map

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

package/dist/index.js

@@ -0,0 +1,188 @@
+#!/usr/bin/env node
+/**
+ * Eddyter MCP server (step 1 — read-only).
+ *
+ * Exposes the admin's editor setup over the Model Context Protocol so AI tools
+ * (Claude Desktop, Cursor, …) can inspect a license key's status and feature
+ * config. Write tools (update_config) and usage land in later steps once the
+ * shared, plan-ceiling-guarded backend service is in place.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { loadConfig } from "./config.js";
+import { EddyterClient, EddyterError } from "./client.js";
+import { renderFeatureSummary, summarizeFeatures } from "./format.js";
+import { getIntegrationSnippet, renderSnippet, } from "./snippets.js";
+const config = loadConfig();
+const client = new EddyterClient(config);
+const server = new McpServer({
+    name: "eddyter",
+    version: "0.1.0",
+});
+const licenseKeyArg = {
+    licenseKey: z
+        .string()
+        .optional()
+        .describe("Eddyter license key (eddyt_…). Optional if EDDYTER_LICENSE_KEY is set in the client config."),
+};
+/** Wrap tool handlers so EddyterError becomes a clean, non-fatal tool error. */
+function textResult(text) {
+    return { content: [{ type: "text", text }] };
+}
+function errorResult(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+server.registerTool("verify_status", {
+    title: "Verify License Status",
+    description: "Check whether an Eddyter license key is valid and active: plan name, paid/free, " +
+        "expiry, subscription status, BYOK mode, and any payment warning. Use this first " +
+        "to confirm the key works before configuring anything.",
+    inputSchema: licenseKeyArg,
+    annotations: { title: "Verify License Status", readOnlyHint: true, openWorldHint: true },
+}, async ({ licenseKey }) => {
+    try {
+        const key = client.resolveLicenseKey(licenseKey);
+        const { data } = await client.validate(key);
+        if (!data)
+            return errorResult("No data returned from Eddyter.");
+        const expires = new Date(data.expiresAt);
+        const daysLeft = Math.ceil((expires.getTime() - Date.now()) / (1000 * 60 * 60 * 24));
+        const lines = [
+            `Status: ${data.isValid ? "✅ valid" : "❌ invalid"} (${data.status})`,
+            `Plan: ${data.planName}${data.isFreePlan ? " (free)" : ""} — ${data.paidPlan ? "paid" : "unpaid"}`,
+            `Subscription: ${data.subscriptionStatus}`,
+            `Expires: ${data.expiresAt} (${daysLeft} day(s) left)`,
+            `BYOK mode: ${data.isByokPlan ? "on (uses your own AI provider keys)" : "off (managed credits)"}`,
+            `Live API: ${data.isLiveApi ? "yes" : "no"} • domain: ${data.apiDomain}`,
+        ];
+        if (data.warning) {
+            lines.push(`⚠️  ${data.warning.message} (${data.warning.daysRemaining} day(s))`);
+        }
+        return textResult(lines.join("\n"));
+    }
+    catch (err) {
+        if (err instanceof EddyterError)
+            return errorResult(err.message);
+        throw err;
+    }
+});
+server.registerTool("get_config", {
+    title: "Get Editor Config",
+    description: "Show the editor feature configuration for a license key: which features are " +
+        "enabled, which are off but allowed by the plan, and which are locked behind a " +
+        "higher plan. Use before changing config so you know what's available.",
+    inputSchema: licenseKeyArg,
+    annotations: { title: "Get Editor Config", readOnlyHint: true, openWorldHint: true },
+}, async ({ licenseKey }) => {
+    try {
+        const key = client.resolveLicenseKey(licenseKey);
+        const { data } = await client.validate(key);
+        if (!data)
+            return errorResult("No data returned from Eddyter.");
+        const summaries = summarizeFeatures(data.customizations, data.planCustomizations);
+        const header = `Editor config for "${data.planName}" plan key:\n`;
+        return textResult(header + "\n" + renderFeatureSummary(summaries));
+    }
+    catch (err) {
+        if (err instanceof EddyterError)
+            return errorResult(err.message);
+        throw err;
+    }
+});
+server.registerTool("get_usage", {
+    title: "Get Usage & Credits",
+    description: "Show the license key owner's AI usage and credits: plan, credits remaining, " +
+        "credits used this period, operation counts, and days until reset. Use to answer " +
+        "'am I about to hit my limit?'.",
+    inputSchema: licenseKeyArg,
+    annotations: { title: "Get Usage & Credits", readOnlyHint: true, openWorldHint: true },
+}, async ({ licenseKey }) => {
+    try {
+        const key = client.resolveLicenseKey(licenseKey);
+        const u = await client.getUsage(key);
+        const lines = [
+            `Plan: ${u.planName}${u.isFreePlan ? " (free)" : ""}${u.isTrial ? " (trial)" : ""}`,
+            `BYOK mode: ${u.isByokPlan ? "on — uses your own provider keys (credits not consumed)" : "off — managed credits"}`,
+            `Credits remaining: ${u.credits.remaining} (plan ${u.credits.planTotal} + purchased ${u.credits.purchasedCredits})`,
+            `Used this period: ${u.currentPeriod.creditsUsed} credits ` +
+                `(${u.currentPeriod.textOperations} text ops, ${u.currentPeriod.imagesGenerated} images)`,
+            `Resets in: ${u.daysUntilReset} day(s)${u.resetDate ? ` (${u.resetDate})` : ""}`,
+        ];
+        return textResult(lines.join("\n"));
+    }
+    catch (err) {
+        if (err instanceof EddyterError)
+            return errorResult(err.message);
+        throw err;
+    }
+});
+server.registerTool("get_integration_snippet", {
+    title: "Get Integration Snippet",
+    description: "Return ready-to-paste, SSR-safe code to add the Eddyter editor to an app. " +
+        "Picks the correct client-only boundary per framework (the editor is a DOM-only " +
+        "React component). Use when setting Eddyter up in a project.",
+    inputSchema: {
+        framework: z
+            .enum(["react", "nextjs-app", "nextjs-pages", "vite", "remix"])
+            .describe("Target framework. Use 'nextjs-app' for App Router, 'nextjs-pages' for Pages Router."),
+    },
+    // Pure/static — no network, no mutation.
+    annotations: { title: "Get Integration Snippet", readOnlyHint: true, openWorldHint: false },
+}, async ({ framework }) => {
+    const snippet = getIntegrationSnippet(framework);
+    return textResult(renderSnippet(snippet));
+});
+// --- Write tools: only registered when the admin opts in (EDDYTER_ALLOW_WRITES) ---
+if (config.allowWrites) {
+    server.registerTool("update_config", {
+        title: "Update Editor Config (live)",
+        description: "Change the editor's feature configuration for a license key (e.g. turn AI chat " +
+            "or tables off/on). Send only the features you want to change — a partial patch. " +
+            "Changes are clamped to the plan (cannot enable locked features) and go live for " +
+            "all users of the key with no redeploy. Call get_config first to see current state.",
+        inputSchema: {
+            ...licenseKeyArg,
+            customizations: z
+                .record(z.any())
+                .describe("Partial EditorConfigTypes patch. Feature toggles live under `toolbarOptions`, " +
+                'e.g. { "toolbarOptions": { "enableAIChat": false, "enableTableOptions": false } }. ' +
+                "Only the keys you include change; everything else is preserved."),
+        },
+        // Mutates LIVE editor behavior for every user of the key — flag it so clients
+        // can prompt for confirmation before the agent applies it.
+        annotations: {
+            title: "Update Editor Config (live)",
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, async ({ licenseKey, customizations }) => {
+        try {
+            const key = client.resolveLicenseKey(licenseKey);
+            const result = await client.updateConfig(key, customizations);
+            const summaries = summarizeFeatures(result.customizations, result.planCustomizations);
+            return textResult("✅ Config updated (live now, no redeploy needed).\n\n" +
+                renderFeatureSummary(summaries));
+        }
+        catch (err) {
+            if (err instanceof EddyterError)
+                return errorResult(err.message);
+            throw err;
+        }
+    });
+}
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    // Logs go to stderr so they never corrupt the stdio JSON-RPC channel.
+    console.error(`[eddyter-mcp] ready • backend=${config.baseUrl} • ` +
+        `default key=${config.defaultLicenseKey ? "set" : "not set"} • ` +
+        `writes=${config.allowWrites ? "ON" : "off (read-only)"}`);
+}
+main().catch((err) => {
+    console.error("[eddyter-mcp] fatal:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/snippets.js

@@ -0,0 +1,168 @@
+/**
+ * Canonical, copy-paste integration snippets for the `eddyter` package.
+ *
+ * The editor is a CLIENT-ONLY React component (it runs Lexical against the DOM
+ * and ships no "use client" / SSR guard itself). So every server-rendered
+ * framework here loads it behind an SSR-safe boundary — this is the #1 thing a
+ * plain LLM gets wrong, and the reason this tool exists.
+ */
+const INSTALL = "npm install eddyter";
+const baseEditor = (envExpr) => `import {
+  ConfigurableEditorWithAuth,
+  EditorProvider,
+} from 'eddyter';
+import 'eddyter/style.css';
+
+export default function Editor() {
+  return (
+    <EditorProvider>
+      <ConfigurableEditorWithAuth
+        apiKey={${envExpr}}
+        onChange={(html) => console.log(html)}
+        onAuthError={(e) => console.error('Eddyter auth failed:', e)}
+      />
+    </EditorProvider>
+  );
+}
+`;
+export function getIntegrationSnippet(framework) {
+    switch (framework) {
+        case "react":
+        case "vite": {
+            const isVite = framework === "vite";
+            const varName = isVite
+                ? "VITE_EDDYTER_API_KEY"
+                : "REACT_APP_EDDYTER_API_KEY";
+            const envExpr = isVite
+                ? "import.meta.env.VITE_EDDYTER_API_KEY"
+                : "process.env.REACT_APP_EDDYTER_API_KEY";
+            return {
+                framework,
+                installCommand: INSTALL,
+                env: { file: ".env", varName, line: `${varName}=your_key_here` },
+                files: [
+                    { path: "src/components/Editor.tsx", action: "create", content: baseEditor(envExpr + "!") },
+                ],
+                notes: [
+                    "Import <Editor /> wherever you want the editor.",
+                    "No SSR boundary needed — this is a client-rendered app.",
+                ],
+            };
+        }
+        case "nextjs-app": {
+            const varName = "NEXT_PUBLIC_EDDYTER_API_KEY";
+            return {
+                framework,
+                installCommand: INSTALL,
+                env: { file: ".env.local", varName, line: `${varName}=your_key_here` },
+                files: [
+                    {
+                        path: "components/Editor.tsx",
+                        action: "create",
+                        content: `'use client';\n\n` + baseEditor("process.env.NEXT_PUBLIC_EDDYTER_API_KEY!"),
+                    },
+                    {
+                        path: "components/EditorClient.tsx",
+                        action: "create",
+                        content: `'use client';
+
+import dynamic from 'next/dynamic';
+
+// Load the editor with SSR disabled — it is a client-only (DOM) component.
+const Editor = dynamic(() => import('./Editor'), { ssr: false });
+
+export default function EditorClient() {
+  return <Editor />;
+}
+`,
+                    },
+                ],
+                notes: [
+                    "Render <EditorClient /> from any App Router page (server or client).",
+                    "ssr:false is required — the editor touches the DOM and will crash if server-rendered.",
+                ],
+            };
+        }
+        case "nextjs-pages": {
+            const varName = "NEXT_PUBLIC_EDDYTER_API_KEY";
+            return {
+                framework,
+                installCommand: INSTALL,
+                env: { file: ".env.local", varName, line: `${varName}=your_key_here` },
+                files: [
+                    { path: "components/Editor.tsx", action: "create", content: baseEditor("process.env.NEXT_PUBLIC_EDDYTER_API_KEY!") },
+                    {
+                        path: "pages/editor.tsx",
+                        action: "create",
+                        content: `import dynamic from 'next/dynamic';
+
+// Disable SSR — the editor is a client-only (DOM) component.
+const Editor = dynamic(() => import('../components/Editor'), { ssr: false });
+
+export default function EditorPage() {
+  return <Editor />;
+}
+`,
+                    },
+                ],
+                notes: [
+                    "Visit /editor, or import the dynamic Editor into any page.",
+                    "ssr:false is required for the Pages Router too.",
+                ],
+            };
+        }
+        case "remix": {
+            const varName = "EDDYTER_API_KEY";
+            return {
+                framework,
+                installCommand: INSTALL,
+                env: { file: ".env", varName, line: `${varName}=your_key_here` },
+                files: [
+                    {
+                        path: "app/components/Editor.client.tsx",
+                        action: "create",
+                        // `.client.tsx` keeps this out of the server bundle in Remix.
+                        content: baseEditor("(window as any).ENV?.EDDYTER_API_KEY"),
+                    },
+                    {
+                        path: "app/routes/editor.tsx",
+                        action: "create",
+                        content: `import { ClientOnly } from 'remix-utils/client-only';
+import Editor from '~/components/Editor.client';
+
+export default function EditorRoute() {
+  // ClientOnly ensures the DOM-only editor never renders on the server.
+  return <ClientOnly fallback={null}>{() => <Editor />}</ClientOnly>;
+}
+`,
+                    },
+                ],
+                notes: [
+                    "The `.client.tsx` suffix + ClientOnly keep the editor off the server.",
+                    "Expose EDDYTER_API_KEY to the client via your root loader's window.ENV, or use a public env strategy.",
+                    "`remix-utils` provides ClientOnly: npm install remix-utils",
+                ],
+            };
+        }
+    }
+}
+/** Compact, agent-readable rendering of a snippet. */
+export function renderSnippet(s) {
+    const files = s.files
+        .map((f) => `--- ${f.action.toUpperCase()} ${f.path} ---\n${f.content}`)
+        .join("\n");
+    return [
+        `Framework: ${s.framework}`,
+        ``,
+        `1) Install:\n   ${s.installCommand}`,
+        ``,
+        `2) Env (${s.env.file}):\n   ${s.env.line}`,
+        ``,
+        `3) Files:`,
+        files,
+        ``,
+        `Notes:`,
+        s.notes.map((n) => `  • ${n}`).join("\n"),
+    ].join("\n");
+}
+//# sourceMappingURL=snippets.js.map

package/dist/snippets.js.map

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

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "eddyter-mcp",
+  "version": "0.1.0",
+  "private": false,
+  "description": "Model Context Protocol server for Eddyter — let your AI agent set up and configure the Eddyter editor.",
+  "type": "module",
+  "bin": {
+    "eddyter-mcp": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "start": "node dist/index.js",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.12.0",
+    "zod": "^3.23.8"
+  },
+  "devDependencies": {
+    "@types/node": "^20.14.0",
+    "typescript": "5.8.2"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}