gearvn-pages-mcp-server 1.0.0

package/.env.example

@@ -0,0 +1,3 @@
+# Required: Your GearVN Pages API Key
+# Get this by calling: POST https://pages.react.uat.gearvn.xyz/v1/api-keys
+API_KEY=sk-your-api-key-here

package/README.md

@@ -0,0 +1,286 @@
+# GearVN Pages MCP Server
+
+MCP (Model Context Protocol) Server cho việc quản lý và deploy các trang HTML tĩnh lên GearVN Pages.
+
+## Tính năng
+
+MCP server này cung cấp 2 tools:
+
+### 1. deploy-page
+Deploy hoặc update một trang HTML tĩnh.
+
+**Parameters:**
+- `title` (string, required): Tiêu đề của trang
+- `content` (string, required): Nội dung HTML đầy đủ của trang. Phải bao gồm complete HTML document với TailwindCSS CDN. JavaScript libraries được phép nhưng phải import qua CDN (ví dụ: Alpine.js, Chart.js, GSAP). Không dùng React, Vue, Angular hoặc build tools
+- `slug` (string, required): URL slug cho trang (ví dụ: "my-page-123")
+
+**Response:**
+```json
+{
+  "success": true,
+  "message": "Page deployed successfully",
+  "url": "https://pages.react.uat.gearvn.xyz/pages/my-page-123"
+}
+```
+
+### 2. list-pages
+Liệt kê tất cả các pages của API key hiện tại.
+
+**Parameters:** Không có
+
+**Response:**
+```json
+{
+  "success": true,
+  "count": 2,
+  "pages": [
+    {
+      "id": 1,
+      "slug": "my-page-123",
+      "title": "My Page",
+      "created_at": "2025-01-20T10:00:00Z",
+      "updated_at": "2025-01-20T10:00:00Z"
+    }
+  ]
+}
+```
+
+## Cài đặt
+
+### Prerequisites
+- Node.js 18 hoặc cao hơn
+- npm hoặc pnpm
+- API key từ GearVN Pages
+
+### Bước 1: Cài đặt dependencies
+
+```bash
+cd mcp-server
+npm install
+# hoặc
+pnpm install
+```
+
+### Bước 2: Build TypeScript
+
+```bash
+npm run build
+# hoặc
+pnpm build
+```
+
+## Cấu hình
+
+MCP server cần 1 environment variable:
+
+- `API_KEY` (required): API key của bạn để authenticate với GearVN Pages API
+
+### Cách lấy API Key
+
+Sử dụng API để tạo API key:
+
+```bash
+curl -X POST https://pages.react.uat.gearvn.xyz/v1/api-keys \
+  -H "Content-Type: application/json" \
+  -d '{"name": "My MCP Key"}'
+```
+
+Response sẽ trả về API key, lưu lại để sử dụng.
+
+## Sử dụng với Claude Desktop
+
+### Bước 1: Thêm vào Claude Desktop config
+
+Mở file config của Claude Desktop:
+- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
+- Windows: `%APPDATA%\Claude\claude_desktop_config.json`
+
+### Bước 2: Thêm MCP server config
+
+**Cách 1: Sử dụng npx (Khuyến nghị)**
+
+```json
+{
+  "mcpServers": {
+    "gearvn-pages": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "/absolute/path/to/backend-webpage-go/mcp-server"
+      ],
+      "env": {
+        "API_KEY": "sk-your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+**Cách 2: Chạy trực tiếp với node**
+
+```json
+{
+  "mcpServers": {
+    "gearvn-pages": {
+      "command": "node",
+      "args": [
+        "/absolute/path/to/backend-webpage-go/mcp-server/dist/index.js"
+      ],
+      "env": {
+        "API_KEY": "sk-your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+**Lưu ý:** Thay `/absolute/path/to/` bằng đường dẫn tuyệt đối đến folder mcp-server của bạn.
+
+### Bước 3: Restart Claude Desktop
+
+Sau khi thêm config, restart Claude Desktop để load MCP server.
+
+## Sử dụng với Cline (VS Code Extension)
+
+### Bước 1: Mở VS Code Settings
+
+1. Mở Command Palette (Cmd+Shift+P / Ctrl+Shift+P)
+2. Gõ "Preferences: Open User Settings (JSON)"
+
+### Bước 2: Thêm MCP server config
+
+Tìm section `cline.mcpServers` và thêm:
+
+**Cách 1: Sử dụng npx (Khuyến nghị)**
+
+```json
+{
+  "cline.mcpServers": {
+    "gearvn-pages": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "/absolute/path/to/backend-webpage-go/mcp-server"
+      ],
+      "env": {
+        "API_KEY": "sk-your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+**Cách 2: Chạy trực tiếp với node**
+
+```json
+{
+  "cline.mcpServers": {
+    "gearvn-pages": {
+      "command": "node",
+      "args": [
+        "/absolute/path/to/backend-webpage-go/mcp-server/dist/index.js"
+      ],
+      "env": {
+        "API_KEY": "sk-your-api-key-here"
+      }
+    }
+  }
+}
+```
+
+### Bước 3: Reload VS Code
+
+Reload window để Cline load MCP server.
+
+## Test MCP Server
+
+Bạn có thể test MCP server bằng cách chạy trực tiếp:
+
+```bash
+export API_KEY="sk-your-api-key-here"
+npm start
+```
+
+Server sẽ chạy trên stdio và chờ nhận input theo MCP protocol.
+
+## Ví dụ sử dụng trong Claude
+
+Sau khi cấu hình xong, bạn có thể sử dụng trong Claude:
+
+### Deploy một trang mới
+
+```
+Hãy deploy một trang HTML với:
+- Title: "Test Page"
+- Content: Một trang HTML hoàn chỉnh với TailwindCSS và một nút button
+- Slug: "test-page-1"
+```
+
+Claude sẽ tự động tạo HTML document hoàn chỉnh với TailwindCSS CDN, sử dụng tool `deploy-page` và trả về URL của trang.
+
+**Lưu ý:** AI Agent sẽ tự động convert nội dung thành HTML chuẩn với:
+- TailwindCSS CDN link trong `<head>`
+- TailwindCSS utility classes cho styling
+- JavaScript libraries qua CDN nếu cần (Alpine.js, Chart.js, etc.)
+- Vanilla JavaScript cũng được (không dùng SPA frameworks như React/Vue/Angular)
+
+### List các pages
+
+```
+Hãy liệt kê tất cả các pages của tôi
+```
+
+Claude sẽ sử dụng tool `list-pages` và hiển thị danh sách pages.
+
+## Development
+
+### Watch mode
+
+```bash
+npm run watch
+# hoặc
+pnpm watch
+```
+
+Sẽ tự động rebuild khi có thay đổi trong source code.
+
+## Troubleshooting
+
+### MCP server không xuất hiện trong Claude
+
+1. Kiểm tra file config đã đúng format JSON
+2. Kiểm tra đường dẫn đến `dist/index.js` là absolute path
+3. Kiểm tra đã build project: `npm run build`
+4. Restart Claude Desktop
+
+### API Key không hoạt động
+
+1. Kiểm tra API key đã được set đúng trong env với key là `API_KEY`
+2. Kiểm tra API key còn valid bằng cách call API trực tiếp:
+
+```bash
+curl -X GET https://pages.react.uat.gearvn.xyz/v1/pages \
+  -H "X-API-Key: your-api-key"
+```
+
+### Permission denied khi chạy
+
+```bash
+chmod +x dist/index.js
+```
+
+## Cấu trúc project
+
+```
+mcp-server/
+├── src/
+│   └── index.ts          # MCP server implementation
+├── dist/                 # Compiled JavaScript (generated)
+├── package.json
+├── tsconfig.json
+└── README.md
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# 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":""}

package/dist/index.js

@@ -0,0 +1,153 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+// Configuration
+const API_BASE_URL = "https://pages.react.uat.gearvn.xyz";
+const API_KEY = process.env.API_KEY;
+if (!API_KEY) {
+    console.error("Error: API_KEY environment variable is required");
+    process.exit(1);
+}
+// API helper function
+async function callAPI(endpoint, method = "GET", body) {
+    const url = `${API_BASE_URL}${endpoint}`;
+    const headers = {
+        "X-API-Key": API_KEY,
+    };
+    if (body) {
+        headers["Content-Type"] = "application/json";
+    }
+    const response = await fetch(url, {
+        method,
+        headers,
+        body: body ? JSON.stringify(body) : undefined,
+    });
+    if (!response.ok) {
+        const errorText = await response.text();
+        throw new Error(`API request failed: ${response.status} ${errorText}`);
+    }
+    return response.json();
+}
+// Tool definitions
+const DEPLOY_PAGE_TOOL = {
+    name: "deploy-page",
+    description: "Deploy or update a static HTML page. If the slug already exists, the page will be updated with the new content and title. IMPORTANT: The content must be a complete, valid HTML document with TailwindCSS for styling. JavaScript libraries are allowed but MUST be loaded via CDN (e.g., Alpine.js, Chart.js, GSAP, etc.). No build tools or npm packages. No React, Vue, or Angular frameworks allowed.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            title: {
+                type: "string",
+                description: "The title of the page",
+            },
+            content: {
+                type: "string",
+                description: "The complete HTML content of the page. Must include <!DOCTYPE html>, <html>, <head> with TailwindCSS CDN link (https://cdn.tailwindcss.com), and <body> tags. Use TailwindCSS utility classes for all styling. JavaScript libraries are allowed but must be imported via CDN links in <script> tags (e.g., Alpine.js from CDN, Chart.js from CDN). Vanilla JavaScript is also acceptable. NO build tools, npm packages, or SPA frameworks (React/Vue/Angular).",
+            },
+            slug: {
+                type: "string",
+                description: "The URL slug for the page (e.g., 'my-page-123'). This will be used in the URL as /pages/{slug}",
+            },
+        },
+        required: ["title", "content", "slug"],
+    },
+};
+const LIST_PAGES_TOOL = {
+    name: "list-pages",
+    description: "List all pages associated with your API key. Returns a summary of each page including id, slug, title, and timestamps. Does not include page content.",
+    inputSchema: {
+        type: "object",
+        properties: {},
+    },
+};
+// Create MCP server
+const server = new Server({
+    name: "gearvn-pages-mcp-server",
+    version: "1.0.0",
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+// Handler for listing available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [DEPLOY_PAGE_TOOL, LIST_PAGES_TOOL],
+    };
+});
+// Handler for tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        if (name === "deploy-page") {
+            const { title, content, slug } = args;
+            // Validate inputs
+            if (!title || !content || !slug) {
+                throw new Error("Missing required parameters: title, content, and slug are required");
+            }
+            // Call the deploy API
+            const response = await callAPI("/v1/deploy", "POST", {
+                title,
+                content,
+                slug,
+            });
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            message: "Page deployed successfully",
+                            url: response.url,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        else if (name === "list-pages") {
+            // Call the list pages API
+            const response = await callAPI("/v1/pages", "GET");
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({
+                            success: true,
+                            count: response.count,
+                            pages: response.pages,
+                        }, null, 2),
+                    },
+                ],
+            };
+        }
+        else {
+            throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: false,
+                        error: errorMessage,
+                    }, null, 2),
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("GearVN Pages MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    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/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "gearvn-pages-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP Server for GearVN Pages deployment and management",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "gearvn-pages-mcp": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "watch": "tsc --watch",
+    "start": "node dist/index.js",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "gearvn"
+  ],
+  "author": "GearVN",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.4"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.2",
+    "typescript": "^5.7.2"
+  }
+}

package/src/index.ts

@@ -0,0 +1,219 @@
+#!/usr/bin/env node
+
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+  Tool,
+} from "@modelcontextprotocol/sdk/types.js";
+
+// Configuration
+const API_BASE_URL = "https://pages.react.uat.gearvn.xyz";
+const API_KEY = process.env.API_KEY;
+
+if (!API_KEY) {
+  console.error("Error: API_KEY environment variable is required");
+  process.exit(1);
+}
+
+// Types
+interface DeployPageArgs {
+  title: string;
+  content: string;
+  slug: string;
+}
+
+interface DeployPageResponse {
+  url: string;
+}
+
+interface PageSummary {
+  id: number;
+  slug: string;
+  title: string;
+  created_at: string;
+  updated_at: string;
+}
+
+interface ListPagesResponse {
+  count: number;
+  pages: PageSummary[];
+}
+
+// API helper function
+async function callAPI<T>(
+  endpoint: string,
+  method: string = "GET",
+  body?: unknown
+): Promise<T> {
+  const url = `${API_BASE_URL}${endpoint}`;
+  const headers: Record<string, string> = {
+    "X-API-Key": API_KEY!,
+  };
+
+  if (body) {
+    headers["Content-Type"] = "application/json";
+  }
+
+  const response = await fetch(url, {
+    method,
+    headers,
+    body: body ? JSON.stringify(body) : undefined,
+  });
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`API request failed: ${response.status} ${errorText}`);
+  }
+
+  return response.json() as Promise<T>;
+}
+
+// Tool definitions
+const DEPLOY_PAGE_TOOL: Tool = {
+  name: "deploy-page",
+  description:
+    "Deploy or update a static HTML page. If the slug already exists, the page will be updated with the new content and title. IMPORTANT: The content must be a complete, valid HTML document with TailwindCSS for styling. JavaScript libraries are allowed but MUST be loaded via CDN (e.g., Alpine.js, Chart.js, GSAP, etc.). No build tools or npm packages. No React, Vue, or Angular frameworks allowed.",
+  inputSchema: {
+    type: "object",
+    properties: {
+      title: {
+        type: "string",
+        description: "The title of the page",
+      },
+      content: {
+        type: "string",
+        description: "The complete HTML content of the page. Must include <!DOCTYPE html>, <html>, <head> with TailwindCSS CDN link (https://cdn.tailwindcss.com), and <body> tags. Use TailwindCSS utility classes for all styling. JavaScript libraries are allowed but must be imported via CDN links in <script> tags (e.g., Alpine.js from CDN, Chart.js from CDN). Vanilla JavaScript is also acceptable. NO build tools, npm packages, or SPA frameworks (React/Vue/Angular).",
+      },
+      slug: {
+        type: "string",
+        description:
+          "The URL slug for the page (e.g., 'my-page-123'). This will be used in the URL as /pages/{slug}",
+      },
+    },
+    required: ["title", "content", "slug"],
+  },
+};
+
+const LIST_PAGES_TOOL: Tool = {
+  name: "list-pages",
+  description:
+    "List all pages associated with your API key. Returns a summary of each page including id, slug, title, and timestamps. Does not include page content.",
+  inputSchema: {
+    type: "object",
+    properties: {},
+  },
+};
+
+// Create MCP server
+const server = new Server(
+  {
+    name: "gearvn-pages-mcp-server",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+// Handler for listing available tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [DEPLOY_PAGE_TOOL, LIST_PAGES_TOOL],
+  };
+});
+
+// Handler for tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    if (name === "deploy-page") {
+      const { title, content, slug } = args as unknown as DeployPageArgs;
+
+      // Validate inputs
+      if (!title || !content || !slug) {
+        throw new Error("Missing required parameters: title, content, and slug are required");
+      }
+
+      // Call the deploy API
+      const response = await callAPI<DeployPageResponse>("/v1/deploy", "POST", {
+        title,
+        content,
+        slug,
+      });
+
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(
+              {
+                success: true,
+                message: "Page deployed successfully",
+                url: response.url,
+              },
+              null,
+              2
+            ),
+          },
+        ],
+      };
+    } else if (name === "list-pages") {
+      // Call the list pages API
+      const response = await callAPI<ListPagesResponse>("/v1/pages", "GET");
+
+      return {
+        content: [
+          {
+            type: "text",
+            text: JSON.stringify(
+              {
+                success: true,
+                count: response.count,
+                pages: response.pages,
+              },
+              null,
+              2
+            ),
+          },
+        ],
+      };
+    } else {
+      throw new Error(`Unknown tool: ${name}`);
+    }
+  } catch (error) {
+    const errorMessage = error instanceof Error ? error.message : String(error);
+    return {
+      content: [
+        {
+          type: "text",
+          text: JSON.stringify(
+            {
+              success: false,
+              error: errorMessage,
+            },
+            null,
+            2
+          ),
+        },
+      ],
+      isError: true,
+    };
+  }
+});
+
+// Start the server
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("GearVN Pages MCP Server running on stdio");
+}
+
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,20 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "Node16",
+    "moduleResolution": "Node16",
+    "lib": ["ES2022"],
+    "outDir": "./dist",
+    "rootDir": "./src",
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "declaration": true,
+    "declarationMap": true,
+    "sourceMap": true
+  },
+  "include": ["src/**/*"],
+  "exclude": ["node_modules", "dist"]
+}