WordPress MCP Server

WordPress MCP Server

Um servidor Model Context Protocol (MCP) para integração com WordPress, compatível com Windows, macOS e Linux.

Visão Geral

Este servidor MCP permite a interação com sites WordPress por meio da API REST do WordPress. Ele fornece ferramentas para criar, recuperar e atualizar posts usando o protocolo JSON-RPC 2.0.

Instalação

1. Clone o repositório
2. Instale as dependências:

npm install

3. Compile o projeto:

npm run build

Configuração

Adicione o servidor ao seu arquivo de configurações MCP com variáveis de ambiente para as credenciais do WordPress:

{
  "mcpServers": {
    "wordpress": {
      "command": "node",
      "args": ["path/to/build/index.js"],
      "env": {
        "WORDPRESS_SITE_URL": "https://your-wordpress-site.com",
        "WORDPRESS_USERNAME": "your-username",
        "WORDPRESS_PASSWORD": "your-app-password"
      }
    }
  }
}

As variáveis de ambiente são:

• WORDPRESS_SITE_URL: URL do seu site WordPress
• WORDPRESS_USERNAME: Nome de usuário do WordPress
• WORDPRESS_PASSWORD: Senha de aplicativo do WordPress

Você também pode fornecer essas credenciais nos parâmetros da solicitação se preferir não usar variáveis de ambiente.

Métodos Disponíveis

create_post

Cria um novo post no WordPress.

Parâmetros:

• siteUrl: (opcional se definido no ambiente) URL do site WordPress
• username: (opcional se definido no ambiente) Nome de usuário do WordPress
• password: (opcional se definido no ambiente) Senha de aplicativo do WordPress
• title: Título do post
• content: Conteúdo do post
• status: (opcional) 'draft' | 'publish' | 'private' (padrão: 'draft')

get_posts

Recupera posts do WordPress.

Parâmetros:

• siteUrl: (opcional se definido no ambiente) URL do site WordPress
• username: (opcional se definido no ambiente) Nome de usuário do WordPress
• password: (opcional se definido no ambiente) Senha de aplicativo do WordPress
• perPage: (opcional) Número de posts por página (padrão: 10)
• page: (opcional) Número da página (padrão: 1)

update_post

Atualiza um post existente no WordPress.

Parâmetros:

• siteUrl: (opcional se definido no ambiente) URL do site WordPress
• username: (opcional se definido no ambiente) Nome de usuário do WordPress
• password: (opcional se definido no ambiente) Senha de aplicativo do WordPress
• postId: ID do post a ser atualizado
• title: (opcional) Novo título do post
• content: (opcional) Novo conteúdo do post
• status: (opcional) 'draft' | 'publish' | 'private'

Nota de Segurança

Por segurança, é recomendado usar senhas de aplicativo do WordPress em vez da senha da sua conta principal. Você pode gerar uma senha de aplicativo no painel do WordPress em Usuários → Segurança → Senhas de Aplicativo.

Exemplo de Uso

Usando variáveis de ambiente:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "create_post",
  "params": {
    "title": "My New Post",
    "content": "Hello World!",
    "status": "draft"
  }
}

Sem variáveis de ambiente:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "create_post",
  "params": {
    "siteUrl": "https://your-wordpress-site.com",
    "username": "your-username",
    "password": "your-app-password",
    "title": "My New Post",
    "content": "Hello World!",
    "status": "draft"
  }
}

Requisitos

• Node.js 20.0.0 ou superior
• Site WordPress com a API REST habilitada
• Senha de aplicativo do WordPress para autenticação

Licença

Licença MIT - Consulte o arquivo LICENSE para obter detalhes