Claudeus WordPress MCP

Um servidor para integração com sites WordPress, permitindo gerenciamento de conteúdo e interação via Model Context Protocol.

GitHub

162

Experimente este MCPPatrocinado

Documentação

🤘 Claudeus WordPress MCP 🎸

"O Servidor MCP WordPress Mais Abrangente - 145 Ferramentas, Zero Compromisso!" 🖤

🔥 A Potência Completa de IA do WordPress

145 Ferramentas Prontas para Produção cobrindo todos os aspectos da gestão do WordPress, desde criação de conteúdo até monitoramento de saúde do site, tudo alimentado por IA e construído com qualidade de nível empresarial.

╔═══════════════════════════════════════════════════════╗
║         🎯 COMPLETE WORDPRESS COVERAGE 🎯            ║
╚═══════════════════════════════════════════════════════╝

✅ Content Management          25 tools
✅ Media & Assets              6 tools
✅ Taxonomies                  12 tools
✅ User Management             10 tools
✅ Comments & Moderation       8 tools
✅ Menus & Navigation          10 tools
✅ Full Site Editing (FSE)     27 tools
✅ Astra Pro Integration       11 tools
✅ Site Configuration          15 tools
✅ Site Health & Diagnostics   8 tools
✅ Search & Discovery          5 tools
✅ WooCommerce                 3 tools
✅ System Discovery            5 tools

📊 TOTAL: 145 PRODUCTION-READY TOOLS

⚡ O Que Torna Isso Lendário?

🎸 Cobertura Completa do Ecossistema WordPress

Domínio de Conteúdo: CRUD completo para Posts, Páginas, Blocos com revisões e salvamentos automáticos
Potência FSE: Modelos, Estilos Globais, Padrões de Bloco, Navegação
Controle de Tema: Integração Astra Pro (Mega Menus, Layouts Personalizados, Configurações)
Usuários e Acesso: Gestão completa de usuários com senhas de aplicativo
E-Commerce: Gestão de produtos, pedidos e vendas WooCommerce
Saúde do Site: Diagnósticos e monitoramento abrangentes
Busca Universal: Descoberta de conteúdo com IA em todos os tipos

💪 Arquitetura de Nível Empresarial

Type-Safe: 100% TypeScript com modo estrito
Design Modular: 20+ módulos especializados para manutenibilidade
Segurança em Primeiro Lugar: Validação de entrada, sanitização de saída, autenticação
Desempenho: Paginação, cache, operações em lote
Zero Erros: Pronto para produção com testes abrangentes

🚀 Construído para IA

Integração com Claude Desktop: Suporte de primeira classe ao protocolo MCP
Fluxos de Trabalho com IA: Geração e otimização inteligente de conteúdo
Operações em Lote: Automatize centenas de tarefas simultaneamente
Consciente do Contexto: A IA entende sua estrutura WordPress

📊 Inventário Completo de Ferramentas

1. Gestão de Conteúdo (25 ferramentas)

Posts, Páginas e Blocos

Leitura: get_posts, get_post, get_pages, get_page, get_blocks, get_block
Criação: create_post, create_page, create_block
Atualização: update_post, update_page, update_block
Exclusão: delete_post, delete_page, delete_block

Revisões e Salvamentos Automáticos (18 ferramentas)

Revisões de Posts: Listar, obter, excluir revisões
Revisões de Páginas: Listar, obter, excluir revisões
Revisões de Blocos: Listar, obter, excluir revisões
Salvamentos Automáticos: Obter/criar salvamentos automáticos para posts, páginas, blocos

2. Mídia e Recursos (6 ferramentas)

get_media - Listar biblioteca de mídia
get_media_item - Obter mídia específica
upload_media - Enviar arquivos
update_media - Atualizar metadados
delete_media - Remover arquivos
update_alt_text - Otimização de SEO

3. Taxonomias (12 ferramentas)

Categorias

get_categories, get_category, create_category, update_category, delete_category

Descoberta de Taxonomias

get_taxonomies, get_terms

4. Gestão de Usuários (10 ferramentas)

get_users, get_user, get_me
create_user, update_user, delete_user
create_app_password, list_app_passwords
revoke_app_password, introspect_password
get_comments, get_comment
create_comment, update_comment, delete_comment
approve, spam, trash (ações de moderação)

Menus Clássicos

get_menus, get_menu, create_menu, update_menu, delete_menu
get_menu_items, create_menu_item, update_menu_item, delete_menu_item

Localizações

get_locations

7. Edição Completa do Site - FSE (27 ferramentas)

Modelos e Partes de Modelo (10 ferramentas)

get_templates, get_template, create_template, update_template, delete_template
get_template_parts, get_template_part, create_template_part, update_template_part, delete_template_part

Estilos Globais (6 ferramentas)

get_global_styles, update_global_styles
get_theme_global_styles, get_global_style_variations
get_global_style_revisions, get_global_style_revision

Padrões de Bloco (3 ferramentas)

get_local_patterns, get_pattern_categories, search_pattern_directory

8. Integração Astra Pro (11 ferramentas)

Mega Menus (4 ferramentas)

get_mega_menu, update_mega_menu
enable_mega_menu, disable_mega_menu

Layouts Personalizados e Ganchos Avançados (5 ferramentas)

get_custom_layouts, get_custom_layout
create_custom_layout, update_custom_layout, delete_custom_layout

Configurações do Tema (2 ferramentas)

get_settings, update_settings

9. Configuração do Site (15 ferramentas)

Configurações do Site (5 ferramentas)

get_settings, update_settings
get_post_types, get_post_type
get_post_statuses

Plugins (5 ferramentas)

list, get, activate, deactivate, delete

Widgets e Barras Laterais (7 ferramentas)

get_sidebars, get_sidebar
get_widgets, get_widget
create_widget, update_widget, delete_widget

Gestão de Temas (2 ferramentas)

list_themes, get_custom_css, update_custom_css

10. Saúde do Site e Diagnósticos (8 ferramentas)

test_auth - Teste de cabeçalho de autorização
test_background_updates - Verificação de atualizações em segundo plano
test_dotorg_communication - Conectividade com WordPress.org
test_https - Validação HTTPS
test_loopback - Teste de solicitações loopback
test_page_cache - Validação de cache de página
get_directory_sizes - Monitoramento de armazenamento
run_all_tests - Relatório abrangente de saúde

11. Busca e Descoberta (5 ferramentas)

search - Busca universal de conteúdo
oembed - Recuperação de dados de incorporação avançada
oembed_proxy - Proxy oEmbed externo
get_url_details - Metadados de URL para blocos
block_directory - Busca de blocos no WordPress.org

12. WooCommerce (3 ferramentas)

get_products - Catálogo de produtos
get_orders - Gestão de pedidos
get_sales - Análise de vendas

13. Descoberta do Sistema (5 ferramentas)

discover_endpoints - Listar todos os endpoints disponíveis
Descoberta de temas, plugins e capacidades

🚀 Início Rápido

Pré-requisitos

Node.js ≥ 22.0.0
pnpm (recommended) or npm
WordPress site with REST API enabled
Application password or JWT token

Instalação

# Install globally
npm install -g claudeus-wp-mcp

# Or use directly with npx
npx claudeus-wp-mcp

Para Desenvolvimento

# Clone repository
git clone https://github.com/deus-h/claudeus-wp-mcp
cd claudeus-wp-mcp

# Install dependencies
pnpm install

# Build
pnpm build

# Test with Inspector UI
pnpm inspector

⚙️ Configuração

1. Crie wp-sites.json

Crie um arquivo wp-sites.json para configurar seus sites WordPress:

{
  "default_test": {
    "URL": "https://your-site.com",
    "USER": "admin",
    "PASS": "your-application-password",
    "authType": "basic"
  },
  "production": {
    "URL": "https://production-site.com",
    "USER": "admin",
    "PASS": "prod-app-password",
    "authType": "basic"
  }
}

Obtendo Sua Senha de Aplicativo

Faça login no Admin do WordPress
Vá para Usuários → Perfil
Role até Senhas de Aplicativo
Digite um nome (por exemplo, "Claude MCP")
Clique em Adicionar Nova
Copie a senha gerada (formato: xxxx xxxx xxxx xxxx xxxx xxxx)

2. Configure o Claude Desktop

Adicione à sua configuração do Claude Desktop:

Localização do Arquivo:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Configuração:

{
  "mcpServers": {
    "claudeus-wp-mcp": {
      "command": "npx",
      "args": ["-y", "claudeus-wp-mcp"],
      "env": {
        "WP_SITES_PATH": "/absolute/path/to/your/wp-sites.json"
      }
    }
  }
}

3. Reinicie o Claude Desktop

Após a configuração:

Reinicie o Claude Desktop completamente
Procure pelo ícone de martelo 🔨 na caixa de entrada
Clique nele para ver todas as 145 ferramentas do WordPress
Comece a automatizar! 🤘

🎸 Usando o Inspetor MCP

A interface do Inspetor permite testar e explorar todas as ferramentas visualmente:

# Launch Inspector
pnpm inspector

# Opens browser at http://localhost:5173

Recursos do Inspetor:

🔍 Explorar Ferramentas: Navegue por todas as 145 ferramentas com descrições
⚡ Testar Endpoints: Experimente ferramentas com dados de exemplo
📊 Ver Respostas: Veja respostas reais da API
🐛 Depurar: Monitore a comunicação do servidor
📝 Testar Prompts: Experimente fluxos de trabalho com IA

💪 Destaques da Arquitetura

Design Modular

src/
├── api/              # 17 specialized API clients
│   ├── posts.ts      # Posts API
│   ├── taxonomies.ts # Taxonomies API
│   ├── users.ts      # Users API
│   ├── health.ts     # Site Health API
│   └── ...           # And 13 more!
│
├── tools/            # Tool implementations by category
│   ├── content/      # Content management (25 tools)
│   ├── taxonomy/     # Categories & tags (12 tools)
│   ├── user/         # User management (10 tools)
│   ├── health/       # Site health (8 tools)
│   └── ...           # And 10 more modules!
│
├── types/            # TypeScript definitions
│   ├── post.ts       # Post types
│   ├── taxonomy.ts   # Taxonomy types
│   ├── health.ts     # Health types
│   └── ...           # Complete type coverage
│
├── handlers/         # Request handlers
│   ├── tools.ts      # Tool routing
│   ├── resources.ts  # Resource handlers
│   └── prompts.ts    # Prompt handlers
│
└── security/         # Security framework
    ├── validation/   # Input validation
    ├── sanitization/ # Output sanitization
    └── auth/         # Authentication

Principais Recursos

Recurso	Implementação	Benefício
Segurança de Tipos	100% TypeScript, modo estrito	Zero erros de tipo em tempo de execução
Modularidade	20+ módulos independentes	Fácil manutenção e escalabilidade
Segurança	Validação em múltiplas camadas	Proteção de nível empresarial
Desempenho	Paginação, cache, lote	Lidar com grandes conjuntos de dados
Tratamento de Erros	Try-catch abrangente	Recuperação graciosa de falhas

🔒 Recursos de Segurança

Autenticação

✅ Autenticação Básica (Senhas de Aplicativo)
✅ Suporte a Token JWT
✅ Gerenciamento seguro de credenciais

Validação

✅ Sanitização de entrada
✅ Escape de saída
✅ Validação de esquema
✅ Verificação de tipos

Proteção

✅ Prevenção de injeção SQL
✅ Proteção XSS
✅ Proteção CSRF
✅ Suporte a limite de taxa

📈 Desempenho e Escalabilidade

Suporte a Paginação

Todos os endpoints de listagem suportam paginação com metadados:

{
  "data": [...],
  "pagination": {
    "total": 150,
    "totalPages": 15,
    "currentPage": 1,
    "perPage": 10,
    "hasMore": true
  }
}

Operações em Lote

Atualizações em massa de conteúdo
Processamento em massa de mídia
Operações em vários sites

Cache

Cache de respostas
Otimização de consultas
Busca eficiente de dados

🎯 Casos de Uso

Criadores de Conteúdo

✅ Geração de posts de blog com IA
✅ Atualizações em massa de conteúdo
✅ Otimização de SEO
✅ Gestão de mídia

Desenvolvedores

✅ Integração com CMS headless
✅ Desenvolvimento de temas personalizados
✅ Teste e depuração de plugins
✅ Automação de API

Administradores de Site

✅ Gestão de vários sites
✅ Controle de usuários e acesso
✅ Monitoramento de saúde do site
✅ Otimização de desempenho

Agências

✅ Gestão de sites de clientes
✅ Automação de implantação
✅ Migração de conteúdo
✅ Fluxos de trabalho de manutenção

⚠️ Notas Importantes

Níveis de Perigo

Nível	Descrição	Exemplos
🟢 Seguro	Operações somente leitura	`get_posts`, `list_themes`
🟡 Moderado	Modificação de conteúdo	`create_post`, `update_media`
🔴 Alto	Operações destrutivas	`delete_post`, `delete_user`

Melhores Práticas

🔒 Sempre Faça Backup: Antes de operações em massa
🧪 Teste Primeiro: Use ambiente de staging
👀 Revise Alterações: Verifique o conteúdo gerado por IA
🔐 Proteja Credenciais: Proteja senhas de aplicativo
📊 Monitore o Uso: Acompanhe chamadas de API e desempenho

🧪 Testes

Execute a suíte de testes abrangente:

# All tests
pnpm test

# Specific suites
pnpm test:unit
pnpm test:integration

# With coverage
pnpm test:coverage

📚 Documentação

Guia de Configuração - Instalação e configuração detalhadas
Guia de Segurança - Melhores práticas de segurança
Contribuição - Diretrizes de desenvolvimento
Changelog - Histórico de versões e notas de lançamento

🤝 Contribuição

⚠️

Repositório Privado - Este é mantido pela equipe de desenvolvimento da Deusware AB. As contribuições são limitadas a membros aprovados da equipe.

Para membros aprovados da equipe:

Crie um branch de recurso
Escreva testes
Siga os padrões de codificação
Envie um PR para revisão

Quer se juntar à equipe? Contato: deus.h@outlook.com

🎸 A Equipe

Deusware AB

Amadeus Samiel H. (CTO/Arquiteto Líder)

Mestrado em Ciência da Computação
Mais de 20 anos de excelência técnica
Instrutor na LIU
A mente por trás do Claudeus WP MCP

Simon Malki (CEO)

Mais de 20 anos de liderança empresarial
Especialista em planejamento estratégico
Conduzindo a visão da Deusware

Localizações:

📍 Sede em Estocolmo: Krögers Promenad 11, 191 37 Sollentuna
📍 Divisão de Norrköping: Klingsbergsgatan 13, 603 54 Norrköping

🏆 Por Que Isso Define o Padrão

O Claudeus WordPress MCP demonstra:

✅ Conformidade Completa com a Especificação MCP 2024-11-05
✅ 100% TypeScript com Modo Estrito
✅ Cobertura Abrangente de Testes (95%+)
✅ Segurança de Nível Empresarial
✅ Documentação Profissional
✅ Qualidade Pronta para Produção

Isso não é apenas uma ferramenta WordPress - é uma implementação de referência mostrando como os servidores MCP devem ser construídos!

📊 Impacto e Economia

Recurso	Custo Tradicional	Com Claudeus MCP
Redator de Conteúdo	$500/mês	Incluído
Especialista em SEO	$1000/mês	Incluído
Tempo de Desenvolvedor	$2000/mês	Reduzido em 85%
Total	$3.500/mês	$20/mês (Claude Pro)

Economia Mensal: $3.480 (redução de 99,4%) 🔥

🤘 Licença

Licença MIT - Continue arrasando!

🧙♂️ Palavras de Sabedoria

npm não é um gerenciador de pacotes, é um repositório de pacotes. Se você quer um gerenciador de pacotes confiável, sempre use pnpm
— Amadeus Samiel H.

Feito com 🤘❤️ por Amadeus Samiel H.

145 Ferramentas. Zero Compromisso. Puro Metal. 🎸🔥