Servidor MCP Adobe Express | Awesome MCP Servers

Servidor MCP Comunitário para Desenvolvedores de Add-ons do Adobe Express

Este é um servidor Model Context Protocol (MCP) projetado para desenvolvedores de Add-ons do Adobe Express. Ele fornece ferramentas focadas no desenvolvedor para auxiliar na criação de add-ons do Adobe Express e na integração com o SDK do Adobe Express.

Recursos

O servidor fornece as seguintes ferramentas:

Ferramentas do Desenvolvedor

Criar Projeto de Add-on - Crie um novo projeto de add-on do Adobe Express com base em modelos de exemplo
Obter Exemplos de Código - Recupere exemplos de código para recursos comuns de add-ons do Adobe Express (buscados dinamicamente do GitHub quando no modo GitHub)
Implementar Recurso - Obtenha orientação de implementação para adicionar recursos específicos a um add-on do Adobe Express

Ferramentas de Documentação

Obter Capacidades do Assistente - Obtenha informações sobre as capacidades do assistente
Definir Fonte de Conhecimento - Alterne entre os modos de API do GitHub e documentação local
Consultar Documentação - Pesquise a documentação do SDK do Adobe Express e dos Spectrum Web Components

Instalação

Você pode instalar o Adobe Express MCP Server de várias maneiras:

Método 1: Instalar a partir do NPM

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

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

Método 2: Instalar a partir do 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

Método 3: Instalar em um workspace específico do VS Code

Se você quiser usar o servidor MCP em um workspace específico do VS Code:

# 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

Isso criará um arquivo .vscode/mcp.json no seu projeto que configura o servidor MCP do Adobe Express para esse workspace.

Desenvolvimento

# 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

Fontes de Documentação

Este servidor MCP pode acessar documentação de duas fontes:

1. Modo GitHub (Padrão)

No modo GitHub, o servidor usa a API do GitHub para pesquisar e buscar documentação de:

Para usar o modo GitHub, você precisa criar um GitHub Personal Access Token (PAT) e adicioná-lo ao seu arquivo .env:

MCP_GITHUB_PAT=your_github_token_here

2. Modo Local

No modo local, o servidor usa documentação pré-analisada armazenada em um arquivo de base de conhecimento local. Para gerar este arquivo:

Clone os repositórios de documentação:

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

Compile o projeto e execute o analisador:

npm run build
npm run parse-docs

Isso cria um arquivo dist/knowledge_base.json com a documentação analisada.

Você pode alternar entre os modos usando a ferramenta "setKnowledgeSource" ou definindo o KNOWLEDGE_SOURCE_MODE no seu arquivo .env.

Uso com Claude for Desktop

Para usar este servidor MCP com o Claude for Desktop:

Compile o projeto usando npm run build
Abra/crie o arquivo de configuração do Claude for Desktop:
- Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
- Windows: %APPDATA%\Claude\claude_desktop_config.json
Você pode criar/editar este arquivo com o VS Code:
```
# For Mac
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

# For Windows
code %APPDATA%\Claude\claude_desktop_config.json
```
Adicione a configuração do servidor:

{
  "mcpServers": {
    "adobe-express": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/community-express-dev-mcp/dist/index.js"
      ]
    }
  }
}

Substitua /ABSOLUTE/PATH/TO/ pelo caminho real do seu projeto. Por exemplo:
```
"/Users/username/Documents/community-express-dev-mcp/dist/index.js"
```
Salve o arquivo e reinicie o Claude for Desktop
Ao abrir o Claude, você deve ver um ícone de martelo, indicando que as ferramentas MCP estão disponíveis:
Agora você pode usar prompts como "Ajude-me a criar um projeto de add-on de diálogo" ou "Mostre-me exemplos de código para a API de Diálogo" e o Claude usará as ferramentas do desenvolvedor

Exemplos de Prompts

Aqui estão alguns exemplos de prompts para experimentar com o Claude e este servidor MCP:

Exemplos de Ferramentas do Desenvolvedor

"Ajude-me a criar um novo projeto de add-on de diálogo"
"Mostre-me exemplos de código para importar imagens locais em um add-on do Adobe Express"
"Como implemento funcionalidade de arrastar e soltar no meu add-on?"
"Dê-me um exemplo de código de uso da API de Diálogo"
"Ajude-me a implementar autenticação OAuth no meu add-on do Express"

Exemplos de Ferramentas de Documentação

"Quais capacidades este servidor MCP possui?"
"Pesquise documentação sobre botões do Spectrum Web Components"
"Como uso o SDK do Adobe Express no meu add-on?"
"Encontre documentação sobre componentes spectrum-tooltip"
"Alterne para o modo de documentação local"

Uso com VS Code

Este servidor MCP está configurado para funcionar com o modo de agente GitHub Copilot do VS Code. Siga estes passos para usá-lo:

Pré-requisitos

Visual Studio Code (versão 1.99 ou mais recente)
Extensão GitHub Copilot
Ambiente Node.js (v18 ou mais recente recomendado)

Configuração

Opção 1: Usando os Scripts de Instalação

A maneira mais fácil de configurar o servidor MCP no VS Code é usar um dos métodos de instalação descritos na seção Instalação acima. Esses scripts irão:

Criar a configuração correta para o servidor MCP
Gerar uma URL de um clique para instalar no VS Code
Solicitar automaticamente o GitHub PAT quando necessário

Opção 2: Configuração Manual

Se você preferir configurar manualmente:

Certifique-se de ter compilado o projeto: npm run build
Configure o servidor:
- Usando a configuração global MCP nas configurações do VS Code
- OU usando o arquivo .vscode/mcp.json específico do workspace (já incluído neste projeto)
No VS Code, certifique-se de que a configuração chat.mcp.enabled esteja ativada:
- Abra as configurações (Ctrl+, ou Cmd+,)
- Pesquise por chat.mcp.enabled
- Certifique-se de que esteja marcado
Abra a Paleta de Comandos (Ctrl+Shift+P ou Cmd+Shift+P)
Execute MCP: List Servers para ver os servidores disponíveis
Inicie o servidor adobeExpressDev na lista
Quando solicitado, insira seu GitHub Personal Access Token para acessar exemplos de código

Uso com Copilot

Abra a visualização de Chat do VS Code (Ctrl+Alt+I ou Cmd+I)
Selecione "Modo Agente" no menu suspenso
Clique no botão "Ferramentas" para ver as ferramentas disponíveis, incluindo as ferramentas do desenvolvedor do Adobe Express
Faça perguntas como:
- "Crie um novo add-on do Adobe Express que use a API de diálogo"
- "Mostre-me exemplos de código para importar imagens em um add-on do Express"
- "Como implemento autenticação OAuth no meu add-on?"

O servidor MCP aprimora o Copilot com conhecimento especializado em desenvolvimento de add-ons do Adobe Express e exemplos de código extraídos diretamente do repositório oficial de exemplos.

Pacote NPM

O Adobe Express MCP Server está disponível como um pacote npm que você pode instalar globalmente ou como dependência no seu projeto:

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

# Or install as a dev dependency in your project
npm install --save-dev community-express-dev-mcp

Após a instalação, você pode usar os seguintes comandos:

# Install globally in VS Code
express-mcp-install

# Install in current workspace
express-mcp-workspace

# Show help
express-mcp-help

Solução de Problemas

Erro: Tool has no outputSchema but returned structuredContent

Se você encontrar este erro:

Error: MPC -32603: MCP error -32603: Tool queryDocumentation has no outputSchema but returned structuredContent

Isso indica que a ferramenta MCP está retornando conteúdo estruturado, mas não tem um esquema de saída definido corretamente. Isso foi corrigido na versão 1.0.1+.

Solução:

Certifique-se de estar usando a versão mais recente do servidor MCP
Recompile o servidor com npm run build
Reinicie o servidor MCP no seu editor

Se você ainda estiver enfrentando problemas:

Verifique se o formato do esquema de saída segue o formato de esquema MCP (não usando a propriedade .shape do Zod)
Certifique-se de que a estrutura do objeto structuredContent corresponda ao esquema de saída definido
Teste o servidor localmente com o script de teste incluído: npm run test-server

Erro: "cb is not a function"

Este erro geralmente ocorre quando o formato de callback está incorreto em uma função de ferramenta ou quando o valor de retorno da ferramenta não corresponde ao formato esperado.

Solução:

Certifique-se de que a saída da sua ferramenta esteja no formato correto: { structuredContent: {...}, content: [...] }
Evite usar interfaces TypeScript diretamente como valores de retorno; em vez disso, crie um objeto simples que corresponda ao esquema
Verifique se todos os campos obrigatórios no esquema de saída estão presentes no objeto structuredContent

Outros Problemas Comuns

Limitação de Taxa da API do GitHub: Se você estiver no modo GitHub e não fornecer um GitHub Personal Access Token (PAT), pode atingir limites de taxa.
Base de Conhecimento Não Carregando: Se estiver usando o modo local, certifique-se de que o arquivo knowledge_base.json exista na raiz do projeto.
Comando Não Encontrado: Certifique-se de ter compilado o projeto com npm run build antes de tentar executar o servidor.

Licença

MIT