PHP MCP Protocol Server

Servidor MCP (Model Context Protocol) para PHP, que permite integrar o PHP com o Claude AI da Anthropic. Utiliza o SDK MCP oficial para fornecer uma solução robusta e compatível com o protocolo.

Recursos

Execução de código PHP direto do Claude
Implementação baseada no SDK MCP oficial da Anthropic
Tratamento adequado de erros e exceções
Limpeza automática de arquivos temporários
Suporte a verificação do ambiente PHP

Requisitos

Node.js (v14 ou superior)
PHP (v7.0 ou superior)
npm ou yarn

Instalação

Global (recomendado)

npm install -g php-mcp-protocol-server

Após a instalação global, você pode iniciar o servidor com:

php-mcp-server

Local via npm

npm install php-mcp-protocol-server

Via GitHub

git clone https://github.com/Lucasdoreac/php-mcp-protocol-server.git
cd php-mcp-protocol-server
npm install

Uso

Verificar o ambiente PHP

Antes de começar, verifique se o PHP está corretamente instalado:

npm run verify

Iniciar o servidor

npm start

Por padrão, o servidor escutará na porta 7654. Você pode alterar isso definindo a variável de ambiente MCP_PORT.

Integração com o Claude AI

Inicie o servidor PHP MCP
No aplicativo Claude Desktop, configure para usar uma ferramenta MCP local em localhost:7654
Você pode agora executar código PHP diretamente do Claude!

API MCP

O servidor expõe duas ferramentas MCP:

executePhp

Executa código PHP e retorna a saída.

Parâmetros:

code (string): O código PHP a ser executado

Retorno:

output (string): A saída do código PHP
error (string, opcional): Mensagens de erro, se houver
exitCode (number, opcional): Código de saída do processo PHP

phpInfo

Retorna informações detalhadas sobre o ambiente PHP.

Parâmetros: Nenhum

Retorno:

info (string): Informações sobre o ambiente PHP, incluindo versão, extensões e configurações

Exemplo de uso no Claude

Para usar o PHP no Claude, basta pedir para executar código PHP. Por exemplo:

Pode executar este código PHP para mim?

<?php
$data = [
  'nome' => 'Exemplo',
  'valor' => 42,
  'timestamp' => time()
];

echo "Dados em JSON:\n";
echo json_encode($data, JSON_PRETTY_PRINT);
?>

Solução de Problemas

Se o servidor não iniciar ou ocorrerem erros:

Verifique se o PHP está instalado e no PATH do sistema
Confirme que a porta 7654 (ou a configurada) está disponível
Verifique os logs do servidor para mensagens de erro detalhadas

Licença

MIT

php-mcp-protocol-server