@appsai/mcp-server 1.0.0

package/README.md

@@ -0,0 +1,74 @@
+# AppsAI MCP Server
+
+The official Model Context Protocol (MCP) server for AppsAI. Connect Claude Code and other MCP-compatible tools to your AppsAI projects.
+
+## Quick Start
+
+### 1. Get an API Key
+
+1. Sign in to [AppsAI](https://appsai.com)
+2. Go to **Settings → Billing** and scroll to **API Keys**
+3. Click **Create Key** and copy it (shown only once)
+
+### 2. Add to Claude Code
+
+```bash
+claude mcp add appsai --env APPSAI_API_KEY=appsai_xxxxx -- npx @appsai/mcp-server
+```
+
+### 3. Start Building
+
+```
+"List my projects"
+"Create a new project using the nextjs-starter template"
+"Show the files in project abc123"
+"Add a button component to app/page.tsx"
+"Deploy the frontend"
+```
+
+## Features
+
+- **87 Tools** across 8 categories
+- **Project Management** — Create, list, delete projects
+- **Frontend Development** — Edit React/Next.js components, styles, dependencies
+- **Backend Development** — Manage Parse Server cloud functions
+- **Deployment** — Deploy to AWS with one command
+- **AWS Infrastructure** — Run any AWS CLI command, manage CloudFormation
+- **MongoDB Atlas** — Database and cluster management
+- **Pay-as-you-go** — Uses your AppsAI credit balance
+
+## Tool Categories
+
+| Category | Tools | Description |
+|----------|-------|-------------|
+| Project | 5 | Create, list, manage projects |
+| Canvas | 25 | Frontend React/Next.js development |
+| Server | 6 | Backend Parse Server development |
+| System | 5 | Deployment & environment |
+| AWS | 12 | Infrastructure via CLI + CloudFormation |
+| MongoDB | 18 | Database operations |
+| Agent | 9 | AI prompt management |
+| Shared | 7 | Cross-category communication |
+
+## Billing
+
+Usage is charged to your AppsAI credit balance:
+- **File operations** — Free
+- **AI generation** — Model-based pricing
+- **AWS operations** — Based on resources
+- **MongoDB** — Based on cluster tier
+- **Deployment** — Per deployment
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `APPSAI_API_KEY` | Yes | Your API key from Settings → Billing |
+
+## Documentation
+
+Full documentation: [appsai.com/docs/mcp](https://appsai.com/docs/mcp)
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+/**
+ * AppsAI MCP Server
+ *
+ * Exposes AppsAI tools to LLMs via the Model Context Protocol.
+ * Supports all AI tool categories: project, canvas, server, system, aws, mongodb, agent.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,108 @@
+#!/usr/bin/env node
+/**
+ * AppsAI MCP Server
+ *
+ * Exposes AppsAI tools to LLMs via the Model Context Protocol.
+ * Supports all AI tool categories: project, canvas, server, system, aws, mongodb, agent.
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema, } from '@modelcontextprotocol/sdk/types.js';
+import * as dotenv from 'dotenv';
+import { getAllTools, executeToolCall } from './tools.js';
+import { validateAPIKey, initializeParse } from './utils/parse.js';
+// Load environment variables
+dotenv.config();
+// Get API key from environment
+const API_KEY = process.env.APPSAI_API_KEY;
+// Cached user ID after validation
+let cachedUserId = null;
+/**
+ * Validate the API key and cache the user ID
+ */
+async function ensureAuthenticated() {
+    if (cachedUserId) {
+        return cachedUserId;
+    }
+    if (!API_KEY) {
+        throw new Error('APPSAI_API_KEY environment variable is required');
+    }
+    const result = await validateAPIKey(API_KEY);
+    if (!result.valid) {
+        throw new Error(result.error || 'Invalid API key');
+    }
+    cachedUserId = result.userId;
+    return cachedUserId;
+}
+/**
+ * Create and configure the MCP server
+ */
+async function createServer() {
+    // Initialize Parse SDK
+    initializeParse();
+    const server = new Server({
+        name: 'appsai',
+        version: '1.0.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // Handle tool listing
+    server.setRequestHandler(ListToolsRequestSchema, async () => {
+        try {
+            // Validate API key on first request
+            await ensureAuthenticated();
+            const tools = await getAllTools();
+            console.error(`[MCP] Returning ${tools.length} tools`);
+            return { tools };
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            console.error(`[MCP] Error listing tools: ${message}`);
+            // Return empty tools if auth fails
+            return { tools: [] };
+        }
+    });
+    // Handle tool calls
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        console.error(`[MCP] Tool call: ${name}`);
+        try {
+            // Ensure authenticated
+            const userId = await ensureAuthenticated();
+            // Execute the tool
+            const result = await executeToolCall(name, args || {}, userId);
+            return result;
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : 'Unknown error';
+            console.error(`[MCP] Error executing ${name}: ${message}`);
+            return {
+                content: [{ type: 'text', text: `Authentication error: ${message}` }],
+                isError: true,
+            };
+        }
+    });
+    return server;
+}
+/**
+ * Main entry point
+ */
+async function main() {
+    console.error('[MCP] Starting AppsAI MCP Server...');
+    try {
+        const server = await createServer();
+        const transport = new StdioServerTransport();
+        await server.connect(transport);
+        console.error('[MCP] Server connected and ready');
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        console.error(`[MCP] Fatal error: ${message}`);
+        process.exit(1);
+    }
+}
+// Run the server
+main();
+//# 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/tools.d.ts

@@ -0,0 +1,22 @@
+/**
+ * MCP Tool Registry
+ *
+ * Converts OpenAI-style tool definitions to MCP format and routes tool calls.
+ */
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export type ToolCategory = 'project' | 'canvas' | 'server' | 'system' | 'aws' | 'mongodb' | 'agent' | 'shared';
+/**
+ * Get all MCP tools
+ * Fetches tool definitions from Parse Server
+ */
+export declare function getAllTools(): Promise<Tool[]>;
+/**
+ * Execute a tool call
+ */
+export declare function executeToolCall(toolName: string, args: Record<string, unknown>, userId: string): Promise<{
+    content: Array<{
+        type: 'text';
+        text: string;
+    }>;
+    isError?: boolean;
+}>;

package/dist/tools.js

@@ -0,0 +1,183 @@
+/**
+ * MCP Tool Registry
+ *
+ * Converts OpenAI-style tool definitions to MCP format and routes tool calls.
+ */
+import { runCloudFunction } from './utils/parse.js';
+/**
+ * Convert an OpenAI-style tool to MCP format
+ */
+function convertToMCPTool(tool, category) {
+    return {
+        name: `${category}_${tool.name}`,
+        description: tool.description,
+        inputSchema: tool.parameters,
+    };
+}
+// Project management tools (new for MCP)
+const projectTools = [
+    {
+        type: 'function',
+        name: 'LIST_PROJECTS',
+        description: 'List all projects owned by or shared with the authenticated user',
+        parameters: {
+            type: 'object',
+            properties: {
+                skip: { type: 'number', description: 'Number of projects to skip (for pagination)' },
+                limit: { type: 'number', description: 'Maximum number of projects to return (default 20)' },
+            },
+            required: [],
+            additionalProperties: false,
+        },
+    },
+    {
+        type: 'function',
+        name: 'GET_TEMPLATES',
+        description: 'Get available starter templates for creating new projects',
+        parameters: {
+            type: 'object',
+            properties: {},
+            required: [],
+            additionalProperties: false,
+        },
+    },
+    {
+        type: 'function',
+        name: 'CREATE_PROJECT',
+        description: 'Create a new project from a starter template',
+        parameters: {
+            type: 'object',
+            properties: {
+                templateS3Key: { type: 'string', description: 'S3 key of the starter template to use' },
+            },
+            required: ['templateS3Key'],
+            additionalProperties: false,
+        },
+    },
+    {
+        type: 'function',
+        name: 'GET_PROJECT_DETAILS',
+        description: 'Get detailed information about a specific project',
+        parameters: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string', description: 'The project ID' },
+            },
+            required: ['projectId'],
+            additionalProperties: false,
+        },
+    },
+    {
+        type: 'function',
+        name: 'DELETE_PROJECT',
+        description: 'Delete a project (owner only). This action cannot be undone.',
+        parameters: {
+            type: 'object',
+            properties: {
+                projectId: { type: 'string', description: 'The project ID to delete' },
+            },
+            required: ['projectId'],
+            additionalProperties: false,
+        },
+    },
+];
+// Map project tool names to cloud functions
+const projectToolToCloudFunction = {
+    LIST_PROJECTS: 'getUserProjects',
+    GET_TEMPLATES: 'getTemplates',
+    CREATE_PROJECT: 'createProject',
+    GET_PROJECT_DETAILS: 'getProjectDetails',
+    DELETE_PROJECT: 'deleteProject',
+};
+// Map category tools to cloud functions
+const categoryToolToCloudFunction = {
+    project: 'executeProjectTool',
+    canvas: 'executeMCPTool',
+    server: 'executeMCPTool',
+    system: 'executeMCPTool',
+    aws: 'executeMCPTool',
+    mongodb: 'executeMCPTool',
+    agent: 'executeMCPTool',
+    shared: 'executeMCPTool',
+};
+/**
+ * Get all MCP tools
+ * Fetches tool definitions from Parse Server
+ */
+export async function getAllTools() {
+    const tools = [];
+    // Add project tools (defined locally)
+    for (const tool of projectTools) {
+        tools.push(convertToMCPTool(tool, 'project'));
+    }
+    // Fetch category tools from backend
+    try {
+        const result = await runCloudFunction('getMCPToolDefinitions', {});
+        for (const [category, categoryTools] of Object.entries(result.tools)) {
+            for (const tool of categoryTools) {
+                tools.push(convertToMCPTool(tool, category));
+            }
+        }
+    }
+    catch (error) {
+        console.error('[Tools] Failed to fetch tool definitions from backend:', error);
+        // Return just project tools if backend is unavailable
+    }
+    return tools;
+}
+/**
+ * Execute a tool call
+ */
+export async function executeToolCall(toolName, args, userId) {
+    // Parse tool name: category_TOOL_NAME
+    const underscoreIndex = toolName.indexOf('_');
+    if (underscoreIndex === -1) {
+        return {
+            content: [{ type: 'text', text: `Invalid tool name format: ${toolName}` }],
+            isError: true,
+        };
+    }
+    const category = toolName.substring(0, underscoreIndex);
+    const name = toolName.substring(underscoreIndex + 1);
+    try {
+        let result;
+        if (category === 'project') {
+            // Handle project tools with direct cloud function mapping
+            const cloudFunction = projectToolToCloudFunction[name];
+            if (!cloudFunction) {
+                return {
+                    content: [{ type: 'text', text: `Unknown project tool: ${name}` }],
+                    isError: true,
+                };
+            }
+            result = await runCloudFunction(cloudFunction, { ...args, _mcpUserId: userId });
+        }
+        else {
+            // Handle category tools via unified MCP executor
+            result = await runCloudFunction('executeMCPTool', {
+                category,
+                tool: name,
+                params: args,
+                userId,
+            });
+        }
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+        };
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        const code = error?.code;
+        if (code === 402) {
+            return {
+                content: [{ type: 'text', text: 'Insufficient credits. Please add funds at appsai.com/billing' }],
+                isError: true,
+            };
+        }
+        return {
+            content: [{ type: 'text', text: `Error executing ${toolName}: ${message}` }],
+            isError: true,
+        };
+    }
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/dist/utils/parse.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Parse SDK Client Setup
+ *
+ * Initializes Parse SDK for communicating with the Parse Server.
+ */
+import Parse from 'parse/node.js';
+/**
+ * Initialize Parse SDK with server configuration
+ */
+export declare function initializeParse(): void;
+/**
+ * Run a Parse Cloud function
+ */
+export declare function runCloudFunction<T = unknown>(functionName: string, params: Record<string, unknown>, sessionToken?: string): Promise<T>;
+/**
+ * Validate an API key and get the associated user ID
+ */
+export declare function validateAPIKey(apiKey: string): Promise<{
+    valid: boolean;
+    userId?: string;
+    error?: string;
+}>;
+export { Parse };

package/dist/utils/parse.js

@@ -0,0 +1,51 @@
+/**
+ * Parse SDK Client Setup
+ *
+ * Initializes Parse SDK for communicating with the Parse Server.
+ */
+import Parse from 'parse/node.js';
+let initialized = false;
+/**
+ * Initialize Parse SDK with server configuration
+ */
+export function initializeParse() {
+    if (initialized)
+        return;
+    const serverUrl = process.env.PARSE_SERVER_URL || 'https://internal.appsai.com/server';
+    const appId = process.env.PARSE_APP_ID || 'Rv4CcqHMjTcjAzSDb6vVMnw0Yp99ZQ5Wrvh80PUI';
+    const masterKey = process.env.PARSE_MASTER_KEY;
+    Parse.initialize(appId);
+    Parse.serverURL = serverUrl;
+    if (masterKey) {
+        Parse.masterKey = masterKey;
+    }
+    initialized = true;
+    console.error(`[Parse] Initialized with server: ${serverUrl}`);
+}
+/**
+ * Run a Parse Cloud function
+ */
+export async function runCloudFunction(functionName, params, sessionToken) {
+    initializeParse();
+    const options = {};
+    if (sessionToken) {
+        options.sessionToken = sessionToken;
+    }
+    return Parse.Cloud.run(functionName, params, options);
+}
+/**
+ * Validate an API key and get the associated user ID
+ */
+export async function validateAPIKey(apiKey) {
+    initializeParse();
+    try {
+        const result = await Parse.Cloud.run('validateMCPAPIKey', { apiKey }, { useMasterKey: true });
+        return result;
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : 'Unknown error';
+        return { valid: false, error: message };
+    }
+}
+export { Parse };
+//# sourceMappingURL=parse.js.map

package/dist/utils/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/utils/parse.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,MAAM,eAAe,CAAC;AAElC,IAAI,WAAW,GAAG,KAAK,CAAC;AAExB;;GAEG;AACH,MAAM,UAAU,eAAe;IAC7B,IAAI,WAAW;QAAE,OAAO;IAExB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,IAAI,oCAAoC,CAAC;IACvF,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,0CAA0C,CAAC;IACrF,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAE/C,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC;IACxB,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAE5B,IAAI,SAAS,EAAE,CAAC;QACd,KAAK,CAAC,SAAS,GAAG,SAAS,CAAC;IAC9B,CAAC;IAED,WAAW,GAAG,IAAI,CAAC;IACnB,OAAO,CAAC,KAAK,CAAC,oCAAoC,SAAS,EAAE,CAAC,CAAC;AACjE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,YAAoB,EACpB,MAA+B,EAC/B,YAAqB;IAErB,eAAe,EAAE,CAAC;IAElB,MAAM,OAAO,GAA2B,EAAE,CAAC;IAE3C,IAAI,YAAY,EAAE,CAAC;QACjB,OAAO,CAAC,YAAY,GAAG,YAAY,CAAC;IACtC,CAAC;IAED,OAAO,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,EAAE,OAAO,CAAe,CAAC;AACtE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAAC,MAAc;IACjD,eAAe,EAAE,CAAC;IAElB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,mBAAmB,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,CAI3F,CAAC;QACF,OAAO,MAAM,CAAC;IAChB,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe,CAAC;QACzE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAC1C,CAAC;AACH,CAAC;AAED,OAAO,EAAE,KAAK,EAAE,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@appsai/mcp-server",
+  "version": "1.0.0",
+  "description": "Official MCP server for AppsAI - connect Claude Code to your AppsAI projects",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "appsai-mcp": "dist/index.js"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc --watch",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "dotenv": "^16.0.1",
+    "parse": "^6.1.1"
+  },
+  "devDependencies": {
+    "@types/node": "^18.11.18",
+    "@types/parse": "^3.0.9",
+    "typescript": "^5.0.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "keywords": [
+    "mcp",
+    "appsai",
+    "ai",
+    "llm",
+    "claude",
+    "model-context-protocol",
+    "react",
+    "nextjs",
+    "aws",
+    "mongodb"
+  ],
+  "author": "AppsAI",
+  "license": "MIT",
+  "homepage": "https://appsai.com/docs/mcp",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/appsai/mcp-server"
+  },
+  "bugs": {
+    "url": "https://github.com/appsai/mcp-server/issues"
+  }
+}