WordPress MCP Server

Gerencie sites WordPress e crie conteúdo com imagens em destaque geradas por IA.

GitHub
2

Documentação

WordPress MCP Server 🚀

MCP Python License: MIT

Um servidor Model Context Protocol (MCP) que permite que assistentes de IA gerenciem sites WordPress e criem conteúdo com imagens de destaque geradas por IA.

WordPress + AI = Magic

✨ Recursos

  • 🌐 Gerenciamento Multi-Site - Controle vários sites WordPress a partir de uma única interface
  • 🤖 Conteúdo com IA - Crie artigos com geração automática de imagens de destaque usando DALL-E 3
  • 📝 Publicação Inteligente - Controle total sobre categorias, tags e status de publicação
  • 🔐 Autenticação Segura - Usa Senhas de Aplicativo do WordPress para acesso à API
  • 🌍 Suporte Internacional - Suporte completo a Unicode para hebraico, árabe e outros idiomas
  • ⚡ Operações em Lote - Crie vários artigos em diferentes sites de forma eficiente

🎯 Casos de Uso

  • Agências de Conteúdo - Gerencie vários sites WordPress de clientes em um só lugar
  • Redes de Blogs - Publique conteúdo em vários blogs simultaneamente
  • Escrita Assistida por IA - Deixe a IA ajudar a criar conteúdo com imagens relevantes
  • Publicação Multilíngue - Crie conteúdo em qualquer idioma com suporte adequado

📋 Pré-requisitos

  • Python 3.8 ou superior
  • Claude Desktop (ou qualquer cliente compatível com MCP)
  • Sites WordPress com API REST habilitada
  • Chave de API da OpenAI (para geração de imagens)

🚀 Início Rápido

1. Clonar e Instalar

git clone https://github.com/seomentor/wpmcp.git
cd wpmcp
pip install -r requirements.txt

2. Configurar Sites WordPress

Edite config/wordpress_sites.yaml:

sites:
  - id: "site1"
    name: "My WordPress Blog"
    url: "https://myblog.com"
    username: "your-username"
    password: "your-app-password"

3. Configurar OpenAI (Opcional, para imagens)

Crie um arquivo .env:

OPENAI_API_KEY=your-api-key-here

⚠️ Nota Importante: Se você já tiver um OPENAI_API_KEY definido nas variáveis de ambiente do Windows/Mac, ele pode sobrescrever o do arquivo .env. Para evitar conflitos:

  • Remova qualquer OPENAI_API_KEY existente das variáveis de ambiente do sistema, OU
  • Adicione a chave da API diretamente na configuração do Claude Desktop (veja a opção 2 abaixo)

4. Configurar Claude Desktop

Adicione ao arquivo de configuração do Claude:

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

{
  "mcpServers": {
    "wordpress": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "C:/path/to/wordpress-mcp-server"
    }
  }
}

Opção 2: Incluir a Chave da API da OpenAI na Configuração do Claude (Recomendado se houver problemas)

{
  "mcpServers": {
    "wordpress": {
      "command": "python",
      "args": ["-m", "src.server"],
      "cwd": "C:/path/to/wordpress-mcp-server",
      "env": {
        "OPENAI_API_KEY": "your-openai-api-key-here"
      }
    }
  }
}

5. Comece a Usar!

No Claude Desktop:

"Create an article about AI trends with an image on site1"

📚 Documentação

Comandos Disponíveis

ComandoDescriçãoExemplo
Listar sitesMostrar todos os sites configurados"Mostre-me todos os sites WordPress"
Criar artigoCriar uma nova publicação"Crie um artigo sobre Python no site1"
Criar com imagemCriar publicação com imagem de IA"Crie um artigo com imagem sobre espaço no blog1"
Testar conexãoVerificar acesso ao site"Teste a conexão com o site1"
Obter categoriasListar categorias do site"Mostre as categorias do site1"
Obter tagsListar tags do site"Mostre as tags do site1"

Configuração do WordPress

  1. Habilite a API REST (habilitada por padrão no WordPress 5.0+)

  2. Crie uma Senha de Aplicativo:

    • Vá para Usuários → Perfil → Senhas de Aplicativo
    • Gere uma nova senha
    • Use na configuração

  3. Permissões Necessárias:

    • edit_posts - Criar e editar publicações
    • upload_files - Enviar mídia
    • manage_categories - Criar categorias
    • manage_post_tags - Criar tags

🎨 Geração de Imagens

O servidor usa o DALL-E 3 da OpenAI para geração automática de imagens:

  • Prompts automáticos - Gerados a partir do título e conteúdo do artigo
  • Nomes de arquivo inteligentes - Nomes otimizados para SEO baseados no conteúdo
  • Upload direto - Imagens enviadas diretamente para a biblioteca de mídia do WordPress
  • Imagem de destaque - Definida automaticamente como imagem de destaque da publicação

Custos

  • Qualidade padrão: ~US$ 0,04 por imagem
  • Qualidade HD: ~US$ 0,08 por imagem

🔧 Configuração Avançada

Variáveis de Ambiente

OPENAI_API_KEY=sk-...          # OpenAI API key for image generation

Opções de Configuração

settings:
  default_post_status: "draft"   # draft, publish, private
  default_post_format: "standard"
  max_retries: 3
  timeout: 30

🐛 Solução de Problemas

Ferramenta de Diagnóstico

Execute o script de diagnóstico para verificar sua configuração:

python scripts/diagnose.py

Isso verificará:

  • Versão do Python
  • Dependências necessárias
  • Arquivos de configuração
  • Variáveis de ambiente
  • Conflitos de chave da API da OpenAI
  • Conexão com a OpenAI

Problemas Comuns

"Servidor desconectado"

  • Verifique a instalação do Python
  • Confirme o caminho na configuração do Claude
  • Verifique mensagens de erro no terminal

"Falha na geração de imagem"

  • Verifique se a chave da API da OpenAI é válida
  • Confira os créditos da API
  • Garanta o formato correto do arquivo .env
  • Verifique se há OPENAI_API_KEY conflitante nas variáveis de ambiente do sistema
  • Tente adicionar a chave da API diretamente na configuração do Claude Desktop (veja a Opção 2 acima)

"Falha na autenticação"

  • Regere a senha de aplicativo do WordPress
  • Verifique se o nome de usuário está correto
  • Confirme se a URL do site inclui o protocolo (https://)

🤝 Contribuições

Contribuições são bem-vindas! Sinta-se à vontade para enviar um Pull Request.

  1. Faça um fork do repositório
  2. Crie sua branch de recurso (git checkout -b feature/AmazingFeature)
  3. Faça commit das suas alterações (git commit -m 'Add some AmazingFeature')
  4. Envie para a branch (git push origin feature/AmazingFeature)
  5. Abra um Pull Request

📄 Licença

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

🙏 Agradecimentos

📞 Suporte

Feito com ❤️ por Shay Amos para desenvolvedores WordPress, profissionais de SEO e entusiastas de IA

Visite meu site para mais aplicativos legais :) https://www.seomentor.co.il