WordPress MCP Server

WordPress MCP Server

Um servidor Model Context Protocol (MCP) que permite que assistentes de IA interajam com sites WordPress através da REST API do WordPress. Suporta múltiplos sites WordPress com autenticação segura, permitindo gerenciamento de conteúdo, operações de posts e configuração de sites por meio de linguagem natural.

Recursos

• Suporte a Múltiplos Sites: Conecte-se a vários sites WordPress simultaneamente
• Integração com REST API: Acesso completo aos endpoints da REST API do WordPress
• Autenticação Segura: Usa senhas de aplicativo para acesso seguro à API
• Descoberta Dinâmica de Endpoints: Mapeia automaticamente os endpoints disponíveis para cada site
• Operações Flexíveis: Suporte para métodos GET, POST, PUT, DELETE e PATCH
• Tratamento de Erros: Tratamento gracioso de erros com mensagens significativas
• Configuração Simples: Arquivo de configuração JSON fácil de manter

Instalação

Instalando via Smithery

Para instalar o WordPress Server para Claude Desktop automaticamente via Smithery:

npx -y @smithery/cli install server-wp-mcp --client claude

Instalação Manual

npm install server-wp-mcp

Referência de Ferramentas

wp_discover_endpoints

Mapeia todos os endpoints disponíveis da REST API em um site WordPress.

Argumentos:

{ "site": { "type": "string", "description": "Alias do site (conforme definido na configuração)", "required": true } }

Retorna: Lista de endpoints disponíveis com seus métodos e namespaces.

wp_call_endpoint

Executa requisições REST API para sites WordPress.

Argumentos:

{ "site": { "type": "string", "description": "Alias do site", "required": true }, "endpoint": { "type": "string", "description": "Caminho do endpoint da API", "required": true }, "method": { "type": "string", "enum": ["GET", "POST", "PUT", "DELETE", "PATCH"], "description": "Método HTTP", "default": "GET" }, "params": { "type": "object", "description": "Parâmetros da requisição ou dados do corpo", "required": false } }

Configuração

Obtendo uma Senha de Aplicativo

1. Faça login no painel administrativo do seu WordPress
2. Vá para Usuários → Perfil
3. Role até a seção "Senhas de Aplicativo"
4. Digite um nome para o aplicativo (ex.: "MCP Server")
5. Clique em "Adicionar Nova Senha de Aplicativo"
6. Copie a senha gerada (você não poderá vê-la novamente)

Nota: As Senhas de Aplicativo requerem WordPress 5.6 ou posterior e HTTPS.

Configuração do Arquivo de Configuração

Crie um arquivo de configuração JSON (ex.: wp-sites.json) com os detalhes do seu site WordPress:

{ "myblog": { "URL": "https://myblog.com", "USER": "yourusername", "PASS": "abcd 1234 efgh 5678" }, "testsite": { "URL": "https://test.example.com", "USER": "anotherusername", "PASS": "wxyz 9876 lmno 5432" } }

Cada configuração de site requer:

• URL: URL do site WordPress (deve incluir http:// ou https://)
• USER: Nome de usuário do WordPress
• PASS: Senha de aplicativo (espaços serão removidos automaticamente)

A chave de configuração (ex.: "myblog", "testsite") torna-se o alias do site que você usará ao interagir com o servidor.

Uso com Claude Desktop

Adicione ao seu claude_desktop_config.json:

{ "mcpServers": { "wordpress": { "command": "node", "args": ["path/to/server/dist/index.js"], "env": { "WP_SITES_PATH": "/absolute/path/to/wp-sites.json" } } } }

A variável de ambiente WP_SITES_PATH deve apontar para o caminho absoluto do seu arquivo de configuração.

Exemplo de Uso

Uma vez configurado, você pode pedir ao Claude para realizar várias operações no WordPress:

Listar e Consultar Posts

Can you show me all posts from myblog published in the last month?

Find all posts on testsite tagged with "technology" and "AI"

Show me draft posts from myblog that need review

Criar e Editar Conteúdo

Create a new draft post on testsite titled "The Future of AI" with these key points: [points]

Update the featured image on myblog's latest post about machine learning

Add a new category called "Tech News" to myblog

Gerenciar Comentários

Show me all pending comments on myblog's latest post

Find comments from testsite that might be spam

List the most engaged commenters on myblog

Gerenciamento de Plugins

What plugins are currently active on myblog?

Check if any plugins on testsite need updates

Tell me about the security plugins installed on myblog

Gerenciamento de Usuários

Show me all users with editor role on testsite

Create a new author account on myblog

Update user roles and permissions on testsite

Configurações do Site

What theme is currently active on myblog?

Check the permalink structure on testsite

Show me the current media library settings on myblog

Manutenção e Diagnóstico

Check if there are any broken links on myblog

Show me the PHP version and other system info for testsite

List any pending database updates on myblog

Tratamento de Erros

O servidor trata erros comuns, incluindo:

• Caminho ou formato inválido do arquivo de configuração
• Configurações de site inválidas
• Falhas de autenticação
• Endpoints ausentes ou inválidos
• Limitação de taxa da API
• Erros de rede

Todos os erros são retornados com mensagens descritivas para ajudar a diagnosticar problemas.

Considerações de Segurança

• Mantenha seu arquivo wp-sites.json seguro e nunca o envie para controle de versão
• Considere usar variáveis de ambiente para dados sensíveis em produção
• Armazene o arquivo de configuração fora de diretórios públicos
• Use HTTPS para todos os sites WordPress
• Rotacione regularmente as senhas de aplicativo
• Siga o princípio do menor privilégio ao atribuir papéis de usuário

Dependências

• @modelcontextprotocol/sdk - Implementação do protocolo MCP
• axios - Cliente HTTP para requisições de API

Licença

MIT