Wordpress MCP Integration

🚀 WordPress MCP Integration

This is an optimized TypeScript SDK designed specifically for WordPress integration. It interacts with WordPress websites using the Model Context Protocol (MCP) via the WordPress REST API.

🚀 Quick Start

WordPress MCP Integration enables you to:

• Create new WordPress posts.
• Retrieve existing WordPress posts.
• Update existing WordPress posts.

📦 Installation

1. Clone this repository.
2. Install dependencies:

npm install

📚 Documentation

There are two ways to configure the WordPress collection:

1. Environment Variables

Set the following environment variables:

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

2. Request Parameters

Provide credentials directly when calling the tools.

⚠️ Important Note

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 control panel.

💻 Usage Examples

create_post

Create a new WordPress post. Parameters:

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

Example:

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

get_posts

Retrieve WordPress posts. Parameters:

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

Example:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_posts",
    "arguments": {
      "perPage": 5,
      "page": 1
    }
  }
}

update_post

Update an existing WordPress post. Parameters:

• siteUrl: (Optional if set in environment variables) WordPress site URL.
• username: (Optional if set in environment variables) WordPress username.
• password: (Optional if set in environment variables) 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'.

Example:

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "update_post",
    "arguments": {
      "postId": 1,
      "title": "Updated Post Title",
      "content": "Updated content.",
      "status": "publish"
    }
  }
}

Run the Server

npm run server

Specify a port:

npm run server -- --port 3000

🔧 Technical Details

• Node.js and npm.
• Access to a WordPress site.