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 through the WordPress REST API. It offers the functionality to create, retrieve, and update posts using the JSON - RPC 2.0 protocol.

📦 Installation

1. Clone the repository.
2. Install dependencies:

npm install

3. Build the project:

npm run build

📚 Documentation

Configuration

Add the server to the 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 as an environment variable) WordPress site URL
• username: (Optional if set as an environment variable) WordPress username
• password: (Optional if set as an environment variable) 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 as an environment variable) WordPress site URL
• username: (Optional if set as an environment variable) WordPress username
• password: (Optional if set as an environment variable) 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 as an environment variable) WordPress site URL
• username: (Optional if set as an environment variable) WordPress username
• password: (Optional if set as an environment variable) 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 your 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",
  // The rest of the code should be completed according to the original content
}