generator-app-remote-mcp-server-generic

Adobe App Builder template for creating Model Context Protocol (MCP) servers using the official MCP TypeScript SDK and Adobe I/O Runtime.

What is this template?

Generate MCP servers that run on Adobe I/O Runtime. Connect AI assistants like Cursor, Claude Desktop, and other AI tools to your custom functions, data, and prompts through the standardized MCP protocol.

Key Features

• 🔧 Official MCP TypeScript SDK: Built with @modelcontextprotocol/sdk v1.17.4
• 📝 Type Safety: Zod schema validation for all parameters
• 🚀 Serverless Ready: Deploy to Adobe I/O Runtime with auto-scaling
• 🛠️ Complete MCP Implementation: Tools, Resources, and Prompts support
• 📚 Production Ready: Error handling, logging, and CORS included

Quick Start

Prerequisites

• Node.js 18+
• Adobe I/O CLI: npm install -g @adobe/aio-cli
• Adobe Developer Console project with I/O Runtime enabled

Generate Project

# Using Adobe I/O CLI
aio app init my-mcp-server --template @adobe/generator-app-remote-mcp-server-generic

# Or using npm
npm create @adobe/aio-app my-mcp-server --template @adobe/generator-app-remote-mcp-server-generic

Deploy & Use

cd my-mcp-server
npm install
npm run deploy

Connect to your deployed MCP server in Cursor or Claude Desktop using the provided URL.

Claude Desktop Configuration

Add this to your Claude Desktop configuration file:

{
  "mcpServers": {
    "any-name-you-want-to-provide-for-claude": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://xxxx.adobeioruntime.net/api/v1/web/your-project/mcp-server"
      ]
    }
  }
}

MCP Features

Tools: Interactive functions AI assistants can call (echo, calculator, weather) Resources: Static content access (documentation, data, files)
Prompts: Reusable prompt templates with parameters

All implemented using the official MCP TypeScript SDK

Development

Testing the Generator

# Run unit tests
npm test

# Test end-to-end generation
npm run e2e

Customizing the Template

1. Modify Templates: Edit files in src/templates/
2. Update Generator: Modify src/index.js for prompts/logic
3. Extend Features: Add capabilities in src/templates/actions/mcp-server/tools.js

👥 Contributors

Resources

• 📚 MCP Documentation
• 🔧 MCP TypeScript SDK
• 🏗️ Adobe I/O Runtime
• 📖 App Builder Templates

License

Apache V2 License - see LICENSE for details.