Community MCP Server for Adobe Express Add-on Developers

This is a Model Context Protocol (MCP) server designed for Adobe Express Add-on developers. It provides developer-focused tools to assist with building Adobe Express add-ons and integrating with Adobe Express SDK.

Features

The server provides the following tools:

Developer Tools

1. Scaffold Add-on Project - Create a new Adobe Express add-on project based on sample templates
2. Get Code Examples - Retrieve code examples for common Adobe Express add-on features (dynamically fetched from GitHub when in GitHub mode)
3. Implement Feature - Get implementation guidance for adding specific features to an Adobe Express add-on

Documentation Tools

1. Get Assistant Capabilities - Get information about the assistant's capabilities
2. Set Knowledge Source - Switch between GitHub API and local documentation modes
3. Query Documentation - Search Adobe Express SDK and Spectrum Web Components documentation

Installation

You can install the Adobe Express MCP Server in several ways:

Method 1: Install from NPM

# Install globally
npm install -g community-express-dev-mcp

# Run the VS Code installation script
express-mcp-install

Method 2: Install from GitHub

# Clone the repository
git clone https://github.com/EnventDigital/community-express-dev-mcp.git
cd community-express-dev-mcp

# Install dependencies
npm install

# Build the project
npm run build

# Run the VS Code installation script
npm run install-in-vscode

Method 3: Install in a specific VS Code workspace

If you want to use the MCP server in a specific VS Code workspace:

# If installed globally from NPM:
cd /path/to/your/project
express-mcp-workspace

# If installed from GitHub:
cd /path/to/your/project
/path/to/community-express-dev-mcp/scripts/install-to-workspace.js

This will create a .vscode/mcp.json file in your project that configures the Adobe Express MCP server for that workspace.

Development

# Build the project
npm run build

# Start the server in development mode
npm run dev

# Start the server
npm start

# Parse documentation repositories for local mode
npm run parse-docs

Documentation Sources

This MCP server can access documentation from two sources:

1. GitHub Mode (Default)

In GitHub mode, the server uses the GitHub API to search and fetch documentation from:

• Adobe Express Add-ons Documentation
• Spectrum Web Components

To use GitHub mode, you need to create a GitHub Personal Access Token (PAT) and add it to your .env file:

MCP_GITHUB_PAT=your_github_token_here

2. Local Mode

In local mode, the server uses pre-parsed documentation stored in a local knowledge base file. To generate this file:

1. Clone the documentation repositories:

mkdir -p adobe-docs-repo
git clone https://github.com/AdobeDocs/express-add-ons-docs.git adobe-docs-repo/express-add-ons-docs
git clone https://github.com/adobe/spectrum-web-components.git adobe-docs-repo/spectrum-web-components

2. Build the project and run the parser:

npm run build
npm run parse-docs

3. This creates a dist/knowledge_base.json file with parsed documentation.

You can switch between modes using the "setKnowledgeSource" tool or by setting the KNOWLEDGE_SOURCE_MODE in your .env file.

Usage with Claude for Desktop

To use this MCP server with Claude for Desktop:

1. Build the project using npm run build

2. Open/create Claude for Desktop configuration file:

   • Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

   You can create/edit this file with VS Code:

   # For Mac
   code ~/Library/Ap
   

... View full README on GitHub