php-universal-mcp-server/GITHUB_PUBLISH.md

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

# Passos para Publicação no GitHub e npm

Este documento descreve os passos necessários para publicar o PHP Universal MCP Server no GitHub e npm.

## 1. Publicação no GitHub

```bash
# Inicializar repositório Git
git init

# Adicionar todos os arquivos
git add .

# Fazer commit inicial
git commit -m "Implementação inicial do PHP Universal MCP Server"

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

# Enviar para o GitHub
git push -u origin main
```

## 2. Tornar o CLI executável (em ambientes Unix)

Antes de publicar no npm, certifique-se que o CLI seja executável:

```bash
chmod +x src/cli.js
```

## 3. Preparar para Publicação no npm

Execute o script de preparação:

```bash
node scripts/prepare-npm.js
```

Este script irá:
- Criar um diretório `dist` com todos os arquivos necessários
- Incrementar a versão patch
- Preparar os arquivos para publicação

## 4. Publicar no npm

```bash
# Navegar para o diretório de build
cd dist

# Fazer login no npm (caso necessário)
npm login

# Publicar o pacote
npm publish
```

Se quiser publicar como um pacote escopo:

```bash
npm publish --access public
```

## 5. Verificar Compatibilidade com mcp-installer

Após a publicação, teste a instalação via mcp-installer:

```
Hey Claude, install the MCP server named php-universal-mcp-server
```

O Claude Desktop deve ser capaz de baixar e instalar o servidor MCP através do mcp-installer.

## 6. Criar uma Release no GitHub

Crie uma tag para a versão:

```bash
git tag -a v1.0.0 -m "Versão inicial 1.0.0"
git push origin v1.0.0
```

Em seguida, crie uma release através da interface do GitHub com as notas da versão.