Leonelberio The Wordpress MCP Server

🚀 WordPress MCP Server

A Model Context Protocol (MCP) server for WordPress integration, compatible with Windows, macOS, and Linux.

🚀 Quick Start

This MCP server enables interaction with WordPress sites via the WordPress REST API. It offers tools to create, retrieve, and update posts, utilizing the JSON - RPC 2.0 protocol.

✨ Features

• Compatible with Windows, macOS, and Linux.
• Interacts with WordPress sites through the REST API.
• Uses JSON - RPC 2.0 protocol for communication.

📦 Installation

1. Clone the repository.
2. Install dependencies:

npm install

3. Build the project:

npm run build

📚 Documentation

Configuration

Add the server to your MCP settings file and set WordPress credentials using environment variables:

{
  "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"
      }
    }
  }
}

The environment variables include:

• WORDPRESS_SITE_URL: Your WordPress site URL.
• WORDPRESS_USERNAME: WordPress username.
• WORDPRESS_PASSWORD: WordPress application password.

You can also provide these credentials in the request parameters if you don't want to use environment variables.

Available Methods

create_post

Create a new WordPress post.

Parameters:

• siteUrl: (Optional, if set in env) WordPress site URL.
• username: (Optional, if set in env) WordPress username.
• password: (Optional, if set in env) WordPress application password.
• title: Post title.
• content: Post content.
• status: (Optional) 'draft' | 'publish' | 'private' (Default: 'draft').

get_posts

Retrieve WordPress posts.

Parameters:

• siteUrl: (Optional, if set in env) WordPress site URL.
• username: (Optional, if set in env) WordPress username.
• password: (Optional, if set in env) WordPress application password.
• perPage: (Optional) Number of posts per page (Default: 10).
• page: (Optional) Page number (Default: 1).

update_post

Update an existing WordPress post.

Parameters:

• siteUrl: (Optional, if set in env) WordPress site URL.
• username: (Optional, if set in env) WordPress username.
• password: (Optional, if set in env) WordPress application password.
• postId: ID of the post to update.
• title: (Optional) New post title.
• content: (Optional) New post content.
• status: (Optional) 'draft' | 'publish' | 'private'.

Security Considerations

For security reasons, it is recommended to use a WordPress application password instead of the main account password. You can generate an application password under Users → Security → Application Passwords in the WordPress dashboard.

💻 Usage Examples

Basic Usage

Using environment variables:

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

Advanced Usage

Without using environment variables:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "create_post",
  "params": {
    "siteUrl": "https://your-wordpress-site.com",
    "username": "your-username",
    // The rest of the content in the original should be added here
  }
}