MCP 服务器

wordpress-mcp

MCP server for WordPress REST API that enables managing posts, pages, media, comments, categories, tags, and users through 20 tools.

README

WordPress MCP Server

MCP (Model Context Protocol) server for WordPress REST API. Manage posts, pages, media, comments, categories, tags, and users through 20 tools. Secure and optimized edition.

Works with Claude Desktop, Cursor, VS Code, and any MCP client.

Quick Start

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": ["-y", "@alexgenovese/wordpress-mcp"],
      "env": {
        "WORDPRESS_URL": "https://your-site.com",
        "WORDPRESS_USERNAME": "your-username",
        "WORDPRESS_APP_PASSWORD": "your-application-password"
      }
    }
  }
}

Cursor / VS Code

Add to MCP settings:

{
  "mcpServers": {
    "wordpress": {
      "command": "npx",
      "args": ["-y", "@alexgenovese/wordpress-mcp"],
      "env": {
        "WORDPRESS_URL": "https://your-site.com",
        "WORDPRESS_USERNAME": "your-username",
        "WORDPRESS_APP_PASSWORD": "your-application-password"
      }
    }
  }
}

HTTP Mode (Streamable HTTP)

For remote deployment or shared access:

WORDPRESS_URL=https://your-site.com WORDPRESS_USERNAME=user WORDPRESS_APP_PASSWORD=pass npx @alexgenovese/wordpress-mcp --http

Server starts on port 3000 (configurable via PORT env var). MCP endpoint: http://localhost:3000/mcp

Configuration

Environment Variable	Required	Description
`WORDPRESS_URL`	Yes	WordPress site URL (e.g. `https://your-site.com`)
`WORDPRESS_USERNAME`	Yes	WordPress username
`WORDPRESS_APP_PASSWORD`	Yes	Application Password (see below)
`PORT`	No	Port for HTTP server (default: `3000`, only used with `--http`)

How to Create an Application Password

Go to your WordPress Admin → Users → Profile
Scroll down to Application Passwords
Enter a name (e.g. "MCP Server") and click Add New Application Password
Copy the generated password

Important: WordPress displays the password with spaces for readability (e.g. cUAn CKZ1 u5DN). The server automatically removes spaces — you can paste it as-is.

All Tools (20 tools)

Posts (5 tools)

Tool	Description
`wp_list_posts`	List posts with filters (status, search, per_page)
`wp_get_post`	Get single post with full content
`wp_create_post`	Create post (title, content, status, categories, tags)
`wp_update_post`	Update post fields
`wp_delete_post`	Delete post (moves to trash)

Pages (5 tools)

Tool	Description
`wp_list_pages`	List pages with status filter
`wp_get_page`	Get single page with full content
`wp_create_page`	Create page (title, content, status, parent)
`wp_update_page`	Update page fields
`wp_delete_page`	Delete page

Media (2 tools)

Tool	Description
`wp_list_media`	List media files with type filter
`wp_delete_media`	Permanently delete media file

Comments (4 tools)

Tool	Description
`wp_list_comments`	List comments, filter by post
`wp_create_comment`	Create comment on post
`wp_update_comment`	Moderate comment (approve/hold/spam/trash)
`wp_delete_comment`	Permanently delete comment

Taxonomy (2 tools)

Tool	Description
`wp_list_categories`	List all categories with post counts
`wp_list_tags`	List all tags with post counts

Users & Site (2 tools)

Tool	Description
`wp_list_users`	List users with roles
`wp_get_site_info`	Get site name, description, URL, timezone

Requirements

Node.js 18+
WordPress with REST API enabled (enabled by default)
Application Password (WordPress 5.6+)

For Developers

git clone https://github.com/alexgenovese/mcp-wordpress.git
cd mcp-wordpress
npm install
npm run build

# Run in stdio mode
WORDPRESS_URL=https://your-site.com WORDPRESS_USERNAME=user WORDPRESS_APP_PASSWORD=pass npm start

# Run in dev mode (hot reload)
WORDPRESS_URL=https://your-site.com WORDPRESS_USERNAME=user WORDPRESS_APP_PASSWORD=pass npm run dev

# Run in HTTP mode
WORDPRESS_URL=https://your-site.com WORDPRESS_USERNAME=user WORDPRESS_APP_PASSWORD=pass npm start -- --http