php-universal-mcp-server/PUBLISH_GUIDE.md

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

# Guia de Publicação para PHP Universal MCP Server

Este guia contém instruções passo a passo para publicar o PHP Universal MCP Server no GitHub e npm.

## Pré-requisitos

Antes de começar, certifique-se de que você tem:

1. Git instalado e configurado localmente
2. Uma conta no GitHub com acesso ao repositório https://github.com/Lucasdoreac/php-universal-mcp-server
3. Uma conta npm configurada localmente (`npm login`)
4. Node.js instalado

## Passo 1: Publicar no GitHub

Criamos um script para facilitar este processo. Siga estas etapas:

1. Abra o arquivo `github-publish.bat` em um editor de texto
2. Descomente e configure as linhas `git config user.name` e `git config user.email` com suas informações
3. Execute o script `github-publish.bat` (dando duplo clique no Windows)
4. Se solicitado, forneça suas credenciais do GitHub

Se preferir fazer manualmente, execute estes comandos:

```bash
# Navegue para o diretório do projeto
cd C:\MCP\php-universal-mcp-server

# Inicialize o repositório Git
git init

# Configure o usuário Git (substituir com seus dados)
git config user.name "Seu Nome"
git config user.email "seu.email@exemplo.com"

# Adicione todos os arquivos
git add .

# Faça o commit inicial
git commit -m "feat: implementação completa do PHP Universal MCP Server v1.0.1"

# Conecte ao repositório remoto
git remote add origin https://github.com/Lucasdoreac/php-universal-mcp-server.git

# Envie para o GitHub
git push -u origin main

# Crie uma tag para a versão
git tag -a v1.0.1 -m "Versão 1.0.1 com melhorias na integração MCP"
git push origin v1.0.1
```

## Passo 2: Publicar no npm

Depois de publicar no GitHub, você pode publicar no npm usando o script que criamos:

1. Abra o arquivo `npm-publish.bat` em um editor de texto
2. Descomente a linha `call npm login` se você não estiver logado no npm
3. Execute o script `npm-publish.bat` (dando duplo clique no Windows)

Se preferir fazer manualmente, execute estes comandos:

```bash
# Navegue para o diretório do projeto
cd C:\MCP\php-universal-mcp-server

# Execute o script de preparação
node scripts\prepare.js

# Faça login no npm (se necessário)
npm login

# Publique o pacote
npm publish
```

## Passo 3: Verificar a Publicação

Após a publicação, verifique se:

1. O código foi enviado para o GitHub acessando https://github.com/Lucasdoreac/php-universal-mcp-server
2. O pacote foi publicado no npm verificando https://www.npmjs.com/package/php-universal-mcp-server
3. A versão 1.0.1 está disponível no npm

## Notas Importantes

- Se você já tem um repositório Git configurado localmente, o script `github-publish.bat` pode dar erros. Neste caso, use comandos Git manuais para adicionar, commitar e enviar suas alterações.
- Se o repositório remoto já contém código, você pode precisar primeiro fazer um `git pull` para mesclar as alterações antes de enviar.
- Se o pacote já existe no npm, certifique-se de que a versão no `package.json` foi atualizada para 1.0.1 antes de publicar.

## Problemas Comuns e Soluções

### Erro ao inicializar o Git

Se você receber erros relacionados a `.git` já existindo, você pode estar tentando inicializar um repositório Git dentro de outro. Verifique se não há uma pasta `.git` em nenhum diretório pai.

### Erro ao publicar no npm

Se você receber erros relacionados a versão já existente, verifique se a versão no `package.json` é única e não foi publicada anteriormente.

### Erro ao enviar para o GitHub

Erros de permissão ao enviar para o GitHub geralmente significam que você não tem acesso ao repositório. Confirme se suas credenciais do GitHub estão corretas e se você tem permissão de escrita no repositório.