WordPress MCP Server

Uma ponte segura entre assistentes de IA e WordPress, permitindo gerenciamento de sites e operações de conteúdo por meio de linguagem natural.

GitHub
1

Documentação

WordPress MCP Server

npm version License: MIT Node.js Version PRs Welcome

Um servidor Model Context Protocol (MCP) que permite que assistentes de IA, como o Claude, interajam com sites WordPress por meio de uma interface padronizada.

Descrição

O WordPress MCP Server fornece uma ponte segura entre assistentes de IA e instalações do WordPress, permitindo gerenciamento de conteúdo, administração do site e operações de plugins/temas por meio de interações em linguagem natural. Construído no padrão Model Context Protocol, ele oferece um conjunto abrangente de ferramentas para automação do WordPress.

Recursos

  • Gerenciamento de Conteúdo: Criar, ler, atualizar e excluir posts, páginas e tipos de post personalizados
  • Manipulação de Mídia: Enviar e gerenciar arquivos de mídia com otimização automática
  • Gerenciamento de Usuários: Lidar com operações e permissões de usuários
  • Controle de Plugins e Temas: Instalar, ativar, desativar e gerenciar plugins/temas
  • Configuração do Site: Gerenciar configurações e definições do WordPress
  • Tipos de Post Personalizados: Suporte completo para tipos de post personalizados e taxonomias
  • Integração com SEO: Suporte integrado para plugins de SEO populares
  • Segurança: Autenticação OAuth2 e comunicações seguras via API
  • Operações em Lote: Ações em massa eficientes para conteúdo e mídia
  • Atualizações em Tempo Real: Monitoramento ao vivo do status e da saúde do site

Pré-requisitos

  • Node.js 16.0 ou superior
  • Gerenciador de pacotes npm ou yarn
  • WordPress 5.0 ou superior com REST API habilitada
  • Credenciais de administrador do WordPress válidas ou senhas de aplicativo
  • Claude Code ou qualquer cliente compatível com MCP

Instalação

Início rápido com npx (Recomendado)

npx wordpress-mcp-server init

Instalação Local

# Clone the repository
git clone https://github.com/yourusername/wordpress-mcp-server.git
cd wordpress-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Configure your WordPress connection
npm run configure

Instalação Global

npm install -g wordpress-mcp-server
wordpress-mcp configure

Configuração

Configuração Inicial

  1. Crie um arquivo de configuração:
npx wordpress-mcp-server configure
  1. Ou crie manualmente o wordpress-config.json:
{
  "sites": [
    {
      "name": "my-wordpress-site",
      "url": "https://example.com",
      "username": "admin",
      "password": "your-application-password",
      "authMethod": "basic"
    }
  ],
  "defaultSite": "my-wordpress-site"
}

Métodos de Autenticação

Senhas de Aplicativo (Recomendado)

  1. Vá para Administração do WordPress → Usuários → Seu Perfil
  2. Role até "Senhas de Aplicativo"
  3. Insira um nome e clique em "Adicionar Nova Senha de Aplicativo"
  4. Copie a senha gerada para a sua configuração

Autenticação Básica

  • Requer o plugin HTTP Basic Auth
  • Menos segura, use apenas para desenvolvimento

OAuth2

Exemplos de Uso

Com o Claude Code

  1. Adicione à configuração do Claude Code:
{
  "mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": ["wordpress-mcp-server", "start"]
    }
  }
}
  1. Use comandos em linguagem natural:
"Create a new blog post about AI trends with featured image"
"Update the homepage content"
"Install and activate Yoast SEO plugin"
"Bulk upload images from folder"

Uso Programático

const { WordPressMCP } = require('wordpress-mcp-server');

const mcp = new WordPressMCP({
  site: 'my-wordpress-site'
});

// Create a post
await mcp.tools.createPost({
  title: 'Hello World',
  content: 'This is my first post!',
  status: 'publish'
});

Ferramentas MCP Disponíveis

Ferramentas de Conteúdo

  • wp_create_post - Criar posts, páginas ou tipos de post personalizados
  • wp_update_post - Atualizar conteúdo existente
  • wp_get_post - Recuperar detalhes do post
  • wp_delete_post - Excluir conteúdo
  • wp_list_posts - Listar e filtrar conteúdo

Ferramentas de Mídia

  • wp_upload_media - Enviar imagens, vídeos, documentos
  • wp_get_media - Recuperar informações de mídia
  • wp_delete_media - Remover arquivos de mídia
  • wp_optimize_images - Otimização em massa de imagens

Gerenciamento do Site

  • wp_get_site_info - Detalhes do site e saúde
  • wp_update_settings - Modificar configurações do site
  • wp_clear_cache - Limpar vários caches
  • wp_backup_site - Criar backups do site

Ferramentas de Plugins e Temas

  • wp_install_plugin - Instalar a partir do repositório
  • wp_activate_plugin - Ativar plugins instalados
  • wp_update_plugin - Atualizar para a versão mais recente
  • wp_list_themes - Temas disponíveis

Gerenciamento de Usuários

  • wp_create_user - Adicionar novos usuários
  • wp_update_user - Modificar detalhes do usuário
  • wp_list_users - Obter listagens de usuários
  • wp_manage_roles - Gerenciamento de funções e capacidades

Solução de Problemas

Problemas Comuns

Falha na Conexão

  • Verifique se a URL do WordPress está correta
  • Verifique se a REST API está habilitada: https://yoursite.com/wp-json/
  • Garanta que as credenciais sejam válidas

Erros de Autenticação

  • Senhas de aplicativo exigem WordPress 5.6 ou superior
  • O nome de usuário deve ser o seu nome de login, não o e-mail
  • Alguns hosts bloqueiam a autenticação da REST API

Permissão Negada

  • O usuário precisa das capacidades apropriadas do WordPress
  • Verifique as permissões de instalação de plugins/temas
  • Verifique os limites de upload de arquivos

Modo de Depuração

Habilite o registro detalhado:

export WP_MCP_DEBUG=true
npx wordpress-mcp-server start

Obtendo Ajuda

Contribuindo

Aceitamos contribuições! Consulte nossas Diretrizes de Contribuição para obter detalhes.

Segurança

Para questões de segurança, revise nossa Política de Segurança e relate problemas de forma responsável.

Licença

Este projeto está licenciado sob a Licença MIT - consulte o arquivo LICENSE para obter detalhes.

Agradecimentos

  • Desenvolvido com base no padrão Model Context Protocol
  • Documentação e comunidade da REST API do WordPress
  • Claude e Anthropic pelo desenvolvimento do MCP

Feito com ❤️ para as comunidades WordPress e de IA