MCP 服务器

WordPress MCP Server

Enables AI assistants to manage WordPress sites through natural conversation, supporting post creation, content updates, site queries, and draft-to-publish workflows via the WordPress REST API.

README

WordPress MCP Server

Manage your WordPress site with AI. Create posts, update content, and query your site—all through natural conversation.

What is this?

WordPress MCP is a Model Context Protocol server that connects AI assistants like Claude Code and Cursor to your WordPress site via the REST API.

Instead of switching between your terminal and WordPress admin, just ask:

You: "Create a draft post about our new product launch"
You: "Show me all posts from last week"
You: "Update post 42 to published status"
You: "What plugins are installed on my site?"

Demo

Here's a real conversation showing the draft-to-publish workflow:

You: Create a draft post titled "Why AI Tools Matter for Content Creators"

Claude: I'll create that draft post for you.

✓ Created draft post:
  ID: 142
  Title: Why AI Tools Matter for Content Creators
  Status: draft
  Link: https://your-site.com/?p=142

You: Add some content about productivity and automation

Claude: I'll update the post with content about productivity and automation.

✓ Updated post 142 with new content.

You: Show me my draft posts

Claude: Here are your draft posts:

| ID  | Title                                      | Date       |
|-----|-------------------------------------------|------------|
| 142 | Why AI Tools Matter for Content Creators  | 2026-01-03 |
| 138 | Upcoming Features Preview                  | 2026-01-02 |
| 135 | Team Update Q1                             | 2025-12-28 |

You: Publish post 142

Claude: ✓ Published! Your post is now live at:
https://your-site.com/2026/01/03/why-ai-tools-matter-for-content-creators/

Features

Full CRUD for Posts - Create, read, update, and delete posts
Content Management - List pages, media, and plugins
Search & Filter - Find posts by status, keyword, or date
Draft Workflow - Create drafts, review, then publish
Secure Auth - Uses WordPress Application Passwords

Quick Start

1. Install

git clone https://github.com/gaupoit/wordpress-mcp.git
cd wordpress-mcp
uv sync

2. Create a WordPress Application Password

Go to WordPress Admin → Users → Profile
Scroll to Application Passwords
Enter a name (e.g., "Claude Code") and click Add New
Copy the generated password (you won't see it again!)

3. Configure Claude Code

Add to your Claude Code MCP config (~/.claude.json):

{
  "mcpServers": {
    "wordpress": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/wordpress-mcp", "wordpress-mcp"],
      "env": {
        "WORDPRESS_URL": "https://your-site.com",
        "WORDPRESS_USER": "your-username",
        "WORDPRESS_APP_PASSWORD": "xxxx-xxxx-xxxx-xxxx"
      }
    }
  }
}

4. Restart Claude Code

# Quit and restart
claude

Verify with /mcp - you should see "wordpress" listed.

Available Tools

Reading Content

Tool	Description
`wp_site_info`	Get site name, URL, timezone
`wp_get_posts`	List posts (filter by status, search)
`wp_get_post`	Get single post with full content
`wp_get_pages`	List all pages
`wp_get_media`	List media library items
`wp_get_plugins`	List installed plugins

Writing Content

Tool	Description
`wp_create_post`	Create a new post (draft or published)
`wp_update_post`	Update title, content, status, or excerpt
`wp_delete_post`	Move to trash or permanently delete

Example Workflows

Blog Publishing

You: "Create a draft post titled 'Getting Started with AI' with an intro paragraph"
You: "Show me my draft posts"
You: "Update post 123 - add a conclusion section"
You: "Publish post 123"

Content Audit

You: "List all draft posts"
You: "Search posts for 'outdated'"
You: "What plugins are currently active?"

Bulk Operations

You: "Show me all posts with 'beta' in the title"
You: "Get the full content of post 45, 46, and 47"
You: "Move posts 45 and 46 to trash"

Environment Variables

Variable	Required	Description
`WORDPRESS_URL`	Yes	Your WordPress site URL (e.g., `https://example.com`)
`WORDPRESS_USER`	Yes	WordPress username
`WORDPRESS_APP_PASSWORD`	Yes	Application password (not your login password!)