php-mcp-protocol-server

php-mcp-protocol-server

0
developer_toolsai_chatbot

The PHP MCP Protocol Server integrates PHP with the Claude AI tool from Anthropic using the official MCP SDK, offering a seamless approach to execute PHP code and manage environment details. It features error handling, automatic file cleanup, and easy integration through configurable local server settings.

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

  1. Inicie o servidor PHP MCP
  2. No aplicativo Claude Desktop, configure para usar uma ferramenta MCP local em localhost:7654
  3. 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:

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

Licença

MIT