php-universal-mcp-server/MIGRATION_PLAN.md

Servidor MCP universal para desenvolvimento PHP e criação de sites em qualquer provedor de hospedagem

# Plano de Migração para PHP Universal MCP Server

Este documento detalha o processo de migração do projeto "PHP Hostinger MCP Server" para o novo nome "PHP Universal MCP Server", removendo referências específicas a uma marca e adotando um nome mais universal que reflete a natureza da ferramenta.

## Motivo da Mudança

- Evitar a promoção desnecessária de uma marca específica (Hostinger)
- Refletir melhor a natureza universal da ferramenta que suporta múltiplos provedores
- Alinhar o nome com a verdadeira funcionalidade da ferramenta

## Passos para a Migração

### 1. Criação do Novo Repositório

1. Criar um novo repositório no GitHub com o nome `php-universal-mcp-server`
2. Configurar as mesmas permissões e colaboradores do repositório original
3. Atualizar a descrição refletindo a nova abordagem universal

### 2. Migração do Código

1. Clonar o repositório original localmente
2. Criar uma cópia com todos os arquivos atualizados
3. Substituir todas as referências ao nome antigo em todos os arquivos:
   - Arquivos JavaScript/Node.js
   - Documentação (README.md, API.md, CLI.md)
   - Configurações (package.json, claude-desktop.json)
   - Exemplos e testes

### 3. Alterações Específicas por Arquivo

#### package.json
- Atualizar `name` para "php-universal-mcp-server"
- Atualizar `bin` para usar o novo nome
- Atualizar `description` para refletir a natureza universal
- Atualizar `repository.url` para o novo repositório
- Revisar `keywords` para remover referências específicas

#### src/cli.js
- Atualizar nome do executável
- Atualizar textos de ajuda e descrições
- Atualizar variáveis de ambiente (de HOSTINGER_API_KEY para API_KEY)
- Atualizar mensagens de log

#### README.md e documentação
- Atualizar todos os títulos e referências
- Atualizar exemplos de código
- Atualizar exemplos de comandos CLI
- Atualizar exemplos de configuração

#### Arquivos de provider
- Atualizar para usar API_KEY como padrão em vez de HOSTINGER_API_KEY
- Garantir que a detecção automática priorize todos provedores igualmente

### 4. Preparação para Publicação

1. Executar todos os testes para garantir que a migração não quebrou nada
2. Verificar se todos os providers funcionam corretamente
3. Atualizar script de preparação para npm

### 5. Publicação no NPM

1. Preparar o pacote usando `node scripts/prepare-npm.js`
2. Publicar o novo pacote no npm
3. Verificar a instalação e uso via npx

### 6. Compatibilidade com mcp-installer

1. Testar a instalação via mcp-installer:
   ```
   Hey Claude, install the MCP server named php-universal-mcp-server
   ```
2. Verificar se todas as opções de configuração funcionam corretamente

### 7. Comunicação e Documentação

1. Adicionar uma nota clara sobre a renomeação no README.md do repositório original
2. Documentar a mudança nas notas de lançamento
3. Considerar manter um pacote de compatibilidade no npm que apenas depende do novo pacote

## Cronograma Sugerido

1. **Semana 1**: Criação do repositório e migração de código
2. **Semana 2**: Testes e ajustes finais
3. **Semana 3**: Publicação no npm e documentação

## Impacto para Usuários Existentes

Os usuários existentes precisarão:
1. Atualizar suas instalações: `npm install php-universal-mcp-server`
2. Atualizar seus imports: `const { createServer } = require('php-universal-mcp-server')`
3. Atualizar seus comandos CLI: `npx php-universal-mcp-server` em vez de `npx php-hostinger-mcp-server`
4. Atualizar configurações de variáveis de ambiente

## Considerações Adicionais

- Manter o repositório original temporariamente com uma nota de redirecionamento
- Considerar a criação de um alias de pacote npm para facilitar a transição
- Garantir que o pacote esteja bem documentado para facilitar a migração

## Conclusão

A migração para o nome "PHP Universal MCP Server" é um passo importante para tornar a ferramenta mais neutra e representar adequadamente suas capacidades universais. Esta mudança, embora exija algum esforço inicial, resultará em um produto mais profissional e universalmente aplicável.