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.

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

Resources

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

License

Apache V2 License - see LICENSE for details.