easy-email-pro-mcp 1.55.1

package/CHANGELOG.md

@@ -0,0 +1,9 @@
+# easy-email-pro-mcp
+
+## 1.55.1
+
+### Patch Changes
+
+- modern theme support prebuilt blocks
+- Updated dependencies
+  - easy-email-pro-core@1.56.1

package/README.md

@@ -0,0 +1,196 @@
+# Easy Email Pro MCP Server
+
+MCP (Model Context Protocol) server for helping developers integrate Easy Email Pro and answering questions about Easy Email Pro.
+
+## Features
+
+- **Quick Start Guide**: Get started with Easy Email Pro quickly
+- **Integration Guides**: Framework-specific integration guides (React, Next.js, Vue)
+- **API Reference**: Detailed API documentation
+- **Q&A**: Answer common questions about Easy Email Pro
+
+## Installation
+
+\`\`\`bash
+cd packages/easy-email-pro-mcp
+npm install
+\`\`\`
+
+## Development
+
+\`\`\`bash
+# Start development server
+npm run dev
+
+# The API will be available at http://localhost:3000/api/mcp
+\`\`\`
+
+## Build
+
+\`\`\`bash
+# Build for production
+npm run build
+
+# Start production server
+npm start
+\`\`\`
+
+## Deployment
+
+### Deploy to Vercel
+
+This is a Next.js application, so it can be easily deployed to Vercel:
+
+\`\`\`bash
+# Install Vercel CLI
+npm i -g vercel
+
+# Deploy
+cd packages/easy-email-pro-mcp
+vercel
+\`\`\`
+
+Or connect your GitHub repository to Vercel for automatic deployments.
+
+### MCP Client Configuration
+
+After deployment, configure your MCP client (e.g., Cursor) to use the HTTP API:
+
+\`\`\`json
+{
+  "mcpServers": {
+    "easy-email-pro": {
+      "url": "https://your-domain.vercel.app/api/mcp",
+      "transport": "streamableHttp",
+      "headers": {
+        "x-client-id": "YOUR_CLIENT_ID"
+      }
+    }
+  }
+}
+\`\`\`
+
+Or use query parameter:
+
+\`\`\`json
+{
+  "mcpServers": {
+    "easy-email-pro": {
+      "url": "https://your-domain.vercel.app/api/mcp?client_id=YOUR_CLIENT_ID",
+      "transport": "streamableHttp"
+    }
+  }
+}
+\`\`\`
+
+## Client ID
+
+The HTTP API requires a valid `client_id` for authentication. You can:
+
+- Use `"FREE"` for free tier access
+- Use your enterprise `client_id` if you have a subscription
+- Contact ch.mao@qq.com for a client_id
+
+The `client_id` can be provided via:
+- HTTP header: `x-client-id`
+- Query parameter: `client_id`
+- Authorization header: `Bearer YOUR_CLIENT_ID`
+
+## Available Tools
+
+### 1. get_quick_start
+
+Get a quick start guide for Easy Email Pro.
+
+**Usage:**
+\`\`\`
+get_quick_start({})
+\`\`\`
+
+### 2. get_integration_guide
+
+Get integration guide for a specific framework.
+
+**Parameters:**
+- \`framework\` (optional): "react", "nextjs", or "vue" (default: "react")
+
+**Usage:**
+\`\`\`
+get_integration_guide({ framework: "nextjs" })
+\`\`\`
+
+### 3. get_api_reference
+
+Get API reference documentation.
+
+**Parameters:**
+- \`topic\` (optional): API topic name (EmailEditorProvider, useEditorProps, useSelectedNode, EditorCore, BlockManager, ElementType)
+
+**Usage:**
+\`\`\`
+get_api_reference({ topic: "EmailEditorProvider" })
+\`\`\`
+
+### 4. answer_question
+
+Answer questions about Easy Email Pro.
+
+**Parameters:**
+- \`question\` (required): Your question about Easy Email Pro
+
+**Usage:**
+\`\`\`
+answer_question({ question: "How do I upload images?" })
+\`\`\`
+
+## Example Usage
+
+### Getting Started
+
+\`\`\`
+User: How do I get started with Easy Email Pro?
+AI: I'll help you get started. Let me fetch the quick start guide.
+[Call: get_quick_start({})]
+\`\`\`
+
+### Framework-Specific Help
+
+\`\`\`
+User: How do I integrate Easy Email Pro with Next.js?
+AI: Let me get the Next.js integration guide for you.
+[Call: get_integration_guide({ framework: "nextjs" })]
+\`\`\`
+
+### API Questions
+
+\`\`\`
+User: What props does EmailEditorProvider accept?
+AI: Let me get the API reference for EmailEditorProvider.
+[Call: get_api_reference({ topic: "EmailEditorProvider" })]
+\`\`\`
+
+### General Questions
+
+\`\`\`
+User: How do I handle image uploads?
+AI: Let me answer that for you.
+[Call: answer_question({ question: "How do I handle image uploads?" })]
+\`\`\`
+
+## Knowledge Base
+
+The MCP server includes a knowledge base covering:
+
+- Installation and setup
+- Framework integration (React, Next.js, Vue)
+- API documentation
+- Common questions and answers:
+  - Image upload configuration
+  - Exporting templates (MJML/HTML)
+  - Theme customization
+  - Troubleshooting
+  - Saving and loading templates
+
+## License
+
+Same as Easy Email Pro

package/next.config.js

@@ -0,0 +1,32 @@
+/** @type {import('next').NextConfig} */
+const nextConfig = {
+  output: 'standalone',
+  typescript: {
+    ignoreBuildErrors: false,
+  },
+  // Transpile ESM packages
+  transpilePackages: ['@modelcontextprotocol/sdk'],
+  // Enable experimental features if needed for ES modules
+  experimental: {
+    serverActions: {
+      bodySizeLimit: '2mb',
+    },
+  },
+  webpack: (config, { isServer }) => {
+    // Handle ESM packages in Next.js
+    if (isServer) {
+      // Allow resolving .js extensions for ESM imports
+      config.resolve.extensionAlias = {
+        '.js': ['.js', '.ts', '.tsx'],
+        '.jsx': ['.jsx', '.tsx'],
+      };
+
+      // Ensure proper module resolution for ESM packages
+      config.resolve.mainFields = ['main', 'module'];
+    }
+
+    return config;
+  },
+};
+
+module.exports = nextConfig;

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "easy-email-pro-mcp",
+  "version": "1.55.1",
+  "description": "MCP server for Easy Email Pro integration guidance and Q&A",
+  "keywords": [],
+  "author": "",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.25.2",
+    "crypto-js": "^4.1.1",
+    "easy-email-pro-core": "^1.56.1",
+    "next": "^14.0.0",
+    "react": "^18.2.0",
+    "react-dom": "^18.2.0",
+    "typescript": "^5.9.3"
+  },
+  "devDependencies": {
+    "@types/crypto-js": "^4.1.1",
+    "@types/node": "^20.0.0",
+    "@types/react": "^18.2.0",
+    "@types/react-dom": "^18.2.0",
+    "eslint": "^8.0.0",
+    "eslint-config-next": "^14.0.0"
+  },
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint --fix --ext .tsx,.ts pages src"
+  }
+}

package/pages/api/mcp.ts

@@ -0,0 +1,137 @@
+/**
+ * Next.js API Route for MCP HTTP API
+ * Handles MCP requests via HTTP transport
+ */
+
+import type { NextApiRequest, NextApiResponse } from 'next';
+import { WebStandardStreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js";
+import { createMcpServer } from "../../src/server";
+import { extractClientId, validateClientId } from "../../src/auth";
+
+/**
+ * Convert Next.js request to standard Request object
+ */
+function createRequestFromNext(req: NextApiRequest): Request {
+  // Build URL from Next.js request
+  const protocol = req.headers['x-forwarded-proto'] || 'http';
+  const host = req.headers.host || 'localhost';
+  const path = req.url || '/api/mcp';
+
+  // Add query parameters
+  const queryString = new URLSearchParams();
+  Object.entries(req.query).forEach(([key, value]) => {
+    if (value) {
+      queryString.append(key, Array.isArray(value) ? value[0] : String(value));
+    }
+  });
+
+  const url = `${protocol}://${host}${path}${queryString.toString() ? '?' + queryString.toString() : ''}`;
+
+  // Convert headers
+  const headers = new Headers();
+  Object.entries(req.headers).forEach(([key, value]) => {
+    if (value && key !== 'host') { // Skip host as it's in URL
+      if (Array.isArray(value)) {
+        value.forEach(v => headers.append(key, v));
+      } else {
+        headers.set(key, value);
+      }
+    }
+  });
+
+  // Get body
+  let body: string | undefined;
+  if (req.body) {
+    body = typeof req.body === 'string' ? req.body : JSON.stringify(req.body);
+  }
+
+  return new Request(url, {
+    method: req.method || 'GET',
+    headers,
+    body,
+  });
+}
+
+/**
+ * Convert Response to Next.js response
+ */
+async function sendResponseToNext(res: NextApiResponse, response: Response): Promise<void> {
+  // Set status
+  res.status(response.status);
+
+  // Set headers
+  response.headers.forEach((value, key) => {
+    res.setHeader(key, value);
+  });
+
+  // Send body
+  const text = await response.text();
+  res.send(text);
+}
+
+/**
+ * Next.js API Route handler
+ */
+export default async function handler(
+  req: NextApiRequest,
+  res: NextApiResponse
+) {
+  // Only allow POST requests
+  if (req.method !== 'POST') {
+    return res.status(405).json({
+      jsonrpc: "2.0",
+      error: {
+        code: -32000,
+        message: "Method not allowed. Use POST for MCP requests.",
+      },
+      id: null,
+    });
+  }
+
+  try {
+    // Convert Next.js request to standard Request
+    const request = createRequestFromNext(req);
+
+    // Extract and validate client_id
+    const clientId = extractClientId(request);
+
+    if (!(await validateClientId(clientId))) {
+      return res.status(401).json({
+        jsonrpc: "2.0",
+        error: {
+          code: -32001,
+          message: "Invalid or missing client_id. Please provide a valid client_id in headers (x-client-id) or query params (client_id).",
+        },
+        id: null,
+      });
+    }
+
+    // Create MCP server instance
+    const server = createMcpServer();
+
+    // Create transport in stateless mode (suitable for serverless)
+    const transport = new WebStandardStreamableHTTPServerTransport({
+      sessionIdGenerator: undefined, // Stateless mode
+    });
+
+    // Connect server to transport
+    await server.connect(transport);
+
+    // Handle the request
+    const response = await transport.handleRequest(request);
+
+    // Send response back to Next.js
+    await sendResponseToNext(res, response);
+  } catch (error) {
+    console.error("MCP request error:", error);
+
+    return res.status(500).json({
+      jsonrpc: "2.0",
+      error: {
+        code: -32603,
+        message: error instanceof Error ? error.message : "Internal server error",
+      },
+      id: null,
+    });
+  }
+}

package/src/auth.ts

@@ -0,0 +1,60 @@
+/**
+ * Client ID validation for MCP HTTP API
+ * Uses EditorAuth from easy-email-pro-core for validation
+ */
+
+import { EditorAuth } from "easy-email-pro-core";
+
+/**
+ * Validate client ID using EditorAuth
+ * Returns true if client_id is valid (enterprise or FREE)
+ */
+export async function validateClientId(
+  clientId: string | null | undefined
+): Promise<boolean> {
+  if (!clientId) {
+    return false;
+  }
+
+  // Allow FREE tier
+  if (clientId === "FREE") {
+    return false;
+  }
+
+  try {
+    // Use EditorAuth to validate the client_id
+    await EditorAuth.auth(clientId);
+    const hasEnabled = EditorAuth.getFeatureEnabled('AI_ASSISTANT');
+    return hasEnabled;
+  } catch (error) {
+    console.error("Client ID validation error:", error);
+    return false;
+  }
+}
+
+/**
+ * Extract client ID from request
+ * Checks headers, query params, and body
+ */
+export function extractClientId(request: Request): string | null {
+  // Check header
+  const headerClientId = request.headers.get("x-client-id");
+  if (headerClientId) {
+    return headerClientId;
+  }
+
+  // Check Authorization header (Bearer token format)
+  const authHeader = request.headers.get("authorization");
+  if (authHeader?.startsWith("Bearer ")) {
+    return authHeader.substring(7);
+  }
+
+  // For GET requests, check URL search params
+  const url = new URL(request.url);
+  const queryClientId = url.searchParams.get("client_id");
+  if (queryClientId) {
+    return queryClientId;
+  }
+
+  return null;
+}

package/src/index.ts

@@ -0,0 +1,10 @@
+/**
+ * Easy Email Pro MCP Server
+ *
+ * MCP server for helping developers integrate Easy Email Pro
+ * and answering questions about Easy Email Pro
+ */
+
+export * from "./server";
+export * from "./tools";
+// Note: knowledge exports are for internal use, not re-exported to avoid conflicts