PHP Universal MCP Server
Descrição
O PHP Universal MCP Server é uma poderosa ferramenta que permite gerenciar múltiplos sites e e-commerces através do Claude Desktop usando o Model Context Protocol (MCP). Esta solução unificada facilita o controle de hospedagem, design, produtos e administração de diversos sites sem a necessidade de conhecer os detalhes técnicos de cada plataforma.
Recursos
- Gerenciamento Universal : Interface unificada para diversas plataformas (Hostinger, WooCommerce, Shopify)
- Provedores Cloud : Suporte para AWS, GCP e mais provedores cloud
- Controle Completo : Gerencie hospedagem, domínios, design, produtos e pedidos
- Visualização Avançada : Dashboards e interfaces interativas via artifacts do Claude
- Templates : Sistema completo de design com suporte a Bootstrap 5
- Analytics : Relatórios detalhados com visualização gráfica diretamente no Claude
- Exportação : Exportação de relatórios em formatos CSV, PDF e JSON
- Segurança : Autenticação robusta e armazenamento seguro de credenciais
- Automação : Simplifique tarefas complexas com comandos simples
- Extensibilidade : Arquitetura modular para fácil adição de novos provedores
- Responsividade : Temas adaptados para visualização em dispositivos móveis
- Caching : Sistema otimizado de cache para melhor desempenho
- Sistema de Plugins : Extensão dinâmica de funcionalidades via plugins e marketplace
- Marketing Digital : Sistema integrado de marketing e automação
Componentes
Core
- MCP Protocol Layer : Implementação completa do protocolo MCP sobre JSON-RPC 2.0
- PHP Runtime Engine : Ambiente seguro para execução de código PHP
- Cache System : Sistema de caching para otimização de operações frequentes
- Security Module : Armazenamento seguro de credenciais e autenticação avançada
- Plugin Manager : Sistema para extensão dinâmica de funcionalidades
Módulos
- E-commerce Manager : API unificada para gerenciar produtos, pedidos e clientes
- Analytics System : Sistema completo de relatórios e métricas com visualização via Claude
- Design System : Motor de templates com suporte ao Bootstrap 5 e adaptação responsiva
- Hosting Manager : Gerenciamento de recursos de hospedagem, domínios e SSL
- Export Manager : Sistema de exportação de relatórios em múltiplos formatos
- Marketing Manager : Sistema completo de marketing digital e automação
- Cloud Manager : Gerenciamento unificado de recursos em provedores cloud
Provedores
- Hostinger : Gerenciamento completo de hospedagem web e domínios
- Shopify : Gerenciamento completo de lojas Shopify
- WooCommerce : Gerenciamento de lojas WooCommerce (100% implementado)
- Google : Integração com Google Analytics 4 e Search Console
- Email Marketing : Integrações com Mailchimp e SendinBlue
- Redes Sociais : Integrações com Facebook, Instagram e Twitter
- AWS : Gerenciamento de EC2, S3, e outros serviços AWS
- GCP : Gerenciamento de App Engine, Cloud Storage e outros serviços GCP
Integrações
- Claude Desktop : Interface natural para comandos via chat com visualizações avançadas
Instalação
Requisitos
- Node.js 14.x ou superior
- Claude Desktop 1.3.x ou superior
- Acesso às APIs dos provedores desejados
Instalação Rápida
# Via NPM
npm install -g php-universal-mcp-server
# Ou diretamente via repositório
git clone https://github.com/Lucasdoreac/php-universal-mcp-server.git
cd php-universal-mcp-server
npm install
Configuração
- Configure as credenciais dos provedores:
# Configuração interativa
php-mcp-server configure
# Ou manualmente editando o arquivo
vi config/providers/hostinger.js
- Inicie o servidor:
php-mcp-server start
- Conecte-se ao Claude Desktop:
No Claude Desktop, digite: conectar servidor mcp localhost:7654
Uso Básico
Comandos no Claude Desktop
# Criar um novo site
criar site hostinger meusite.com
# Listar sites
listar sites
# Configurar domínio
configurar domínio site-123 meusite.com
# Configurar SSL
configurar ssl site-123
# Adicionar produto
adicionar produto site-123 "Produto Teste" 99.90
# Gerar dashboard de analytics
analytics dashboard site-123 30 dias
# Exportar relatório
exportar relatório vendas site-123 pdf últimos-30-dias
# Editar template
editar template site-123
# Gerenciar pedidos
pedidos listar site-123
pedidos visualizar site-123 456
pedidos atualizar site-123 456 concluído "Pedido entregue e confirmado pelo cliente"
pedidos dashboard site-123
# Gerenciar plugins
plugins listar
plugins instalar <nome-plugin>
plugins remover <nome-plugin>
# Marketing e SEO
marketing overview site-123
marketing seo analisar site-123 /produto/456
marketing social publicar site-123 facebook,instagram "Nova promoção!"
marketing email criar-campanha site-123 "Newsletter Mensal" "Novidades de Março"
# Cloud Management
cloud aws ec2 listar
cloud gcp app-engine status
cloud storage criar-bucket <nome-bucket>
Uso Programático
const MCPServer = require('php-universal-mcp-server');
// Inicializar o servidor
const server = new MCPServer({
port: 7654,
providers: {
hostinger: {
apiKey: 'sua-api-key'
},
google: {
credentials: require('./google-credentials.json'),
analytics: {
propertyId: 'properties/123456789'
}
},
aws: {
accessKeyId: 'sua-access-key',
secretAccessKey: 'sua-secret-key',
region: 'us-east-1'
}
},
cache: {
enabled: true,
ttl: 3600 // 1 hora em segundos
}
});
// Iniciar o servidor
server.start();
// Utilizar os módulos diretamente
const { hostingManager, marketingManager, cloudManager } = server.modules;
const sites = await hostingManager.listSites();
const instances = await cloudManager.aws.ec2.listInstances();
// Utilizar o sistema de marketing
const marketingOverview = await marketingManager.getOverview('site-123');
const dashboard = await marketingManager.generateMarketingDashboard({
siteId: 'site-123',
dateRange: {
startDate: '2025-01-01',
endDate: '2025-03-20'
}
});
Provedores Cloud
Nossa nova funcionalidade principal na versão 1.10.0 é o suporte a provedores cloud, que oferece:
- AWS : Gerenciamento de EC2, S3, RDS, Lambda, CloudFront, Route53, IAM
- GCP : App Engine, Cloud Storage, Cloud SQL, Cloud Functions e mais
- Interface Unificada : API comum para todos os provedores cloud
- Visualizações via Claude : Dashboards e métricas em tempo real
- Automação : Provisionamento e gerenciamento via comandos simples
- Templates : Modelos pré-configurados para ambientes comuns
Comandos Cloud no Claude Desktop
# AWS
cloud aws ec2 listar
cloud aws ec2 criar <nome> <tipo> <imagem>
cloud aws s3 listar-buckets
cloud aws s3 criar-bucket <nome>
# GCP
cloud gcp app-engine status
cloud gcp app-engine deploy <arquivo>
cloud gcp storage listar-buckets
cloud gcp storage criar-bucket <nome>
# Geral
cloud dashboard <provedor>
cloud custos <provedor> último-mês
cloud recursos listar
Marketplace de Plugins
O sistema de Marketplace de Plugins permite descobrir, instalar e gerenciar plugins de terceiros:
- Descoberta : Navegue por categorias ou busque plugins específicos
- Instalação Simplificada : Instale plugins com um único comando
- Versionamento : Atualizações controladas e automatizadas
- Validação : Verificações de segurança e compatibilidade
- Comunidade : Avaliações e comentários sobre plugins
Comandos do Marketplace no Claude Desktop
# Listar plugins disponíveis
marketplace listar
# Buscar plugins
marketplace buscar <termo>
# Ver detalhes de um plugin
marketplace info <plugin-id>
# Instalar um plugin
marketplace instalar <plugin-id>
# Atualizar um plugin
marketplace atualizar <plugin-id>
# Remover um plugin
marketplace remover <plugin-id>
Sistema de Gerenciamento de Pedidos
Nossa implementação completa do WooCommerce Provider (100%) inclui:
- Dashboard Completo : Visualização interativa de todos os pedidos
- Filtros Avançados : Filtre por status, data, cliente e mais
- Análise de Desempenho : Gráficos de receita e distribuição de status
- Detalhamento de Pedidos : Acesse todas as informações de cada pedido
- Atualização de Status : Gerencie o ciclo de vida dos pedidos
- Processamento de Reembolsos : Gerencie reembolsos completos ou parciais
- Exportação de Dados : Exporte dados de pedidos em múltiplos formatos
Sistema de Marketing Digital
O sistema integrado de marketing digital oferece:
- SEO Avançado : Análise e otimização de SEO, integração com Google Search Console
- Analytics Unificado : Métricas completas via Google Analytics 4
- Email Marketing : Integração com plataformas como Mailchimp e SendinBlue
- Redes Sociais : Publicação e análise em Facebook, Instagram e Twitter
- Tracking e Conversões : Monitoramento de objetivos e funis de conversão
- Automação : Criação automática de conteúdo e campanhas a partir de produtos
Contribuição
Contribuições são bem-vindas! Para contribuir:
- Faça um fork do repositório
- Crie uma branch para sua feature (
git checkout -b feature/nova-feature)
- Commit suas mudanças (
git commit -m 'Adiciona nova feature')
- Push para a branch (
git push origin feature/nova-feature)
- Abra um Pull Request
Documentação
A documentação completa está disponível em:
Roadmap
Licença
Este projeto está licenciado sob a licença MIT - veja o arquivo LICENSE para detalhes.
Suporte
Para suporte, abra uma issue no GitHub ou entre em contato pelo email [email protected].
