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.

$3

- 🔧 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

$3

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

$3

``bash


Using Adobe I/O CLI , You will see tempalte generator-app-remote-mcp-server-generic listed in the all tempaltes list

aio app init

`

$3

`bash
cd my-mcp-server
aio app use
aio app deploy

`

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

$3

Add this to your Claude Desktop configuration file:

`json
{
"mcpServers": {
"mcp-server-name": {
"command": "npx",
"args": [
"mcp-remote",
"https://xxxx.adobeioruntime.net/api/v1/web/your-project/mcp-server"
]
}
}
}
`

$3


`json
{
"mcpServers": {
"mcp-server-name": {
"url": "https://.adobeioruntime.net/api/v1/web//mcp-server",
"type": "streamable-http"
}
}
}
`

$3

" Hey, Can you please ask #mcp-server-name# about weather in Noida? "

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

$3

`bash


Run unit tests

npm test

Test end-to-end generation

npm run e2e
`

$3

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.