mcpField
W
WordPress MCP Server

WordPress MCP Server

Local
github.com/gopalcnepalBusiness & Marketing3Updated 81w ago

About WordPress MCP Server

WordPress MCP Server provides query tools for WordPress sites with the REST API enabled. It is for users who need to read site information and content through an MCP client, with queries for posts, pages, categories, and individual IDs.

Key features

  1. 01Fetch basic site information
  2. 02Retrieve recent posts
  3. 03List categories and filter posts by category
  4. 04Fetch pages
  5. 05Retrieve a post or page by ID

Use cases

  1. 01Inspect WordPress site information in an MCP client
  2. 02Find recent posts or content in a category
  3. 03Retrieve a specific post or page

MCP support

The MCP server exposes queries for WordPress site information, posts, pages, and categories to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

No install method listed yet

We haven’t collected a package or remote endpoint for this server. Follow the instructions in the project README.

Repository

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

WordPress MCP Server

A Model Context Protocol (MCP) server for interacting with WordPress sites. This server provides tools to fetch posts, pages, categories, and site information from any WordPress installation with REST API enabled.

Prerequisites

  • Python 3.13
  • WordPress site with REST API enabled
  • UV package installer (recommended)

Installation

  1. Install UV (Universal Virtualenv):
curl -LsSf https://astral.sh/uv/install.sh | sh
  1. Clone the repository:
git clone <repository-url>
cd wordpress
  1. Create and activate a virtual environment:
uv venv
source .venv/bin/activate  # On Windows, use `.venv\Scripts\activate`
  1. Install dependencies using UV:
uv add "mcp[cli]" httpx

Configuration

  1. Create a .env file in the project root:
WORDPRESS_URL="https://your-wordpress-site.com"

Usage

Using Claude for Desktop:

  • First, start the server:
uv run main.py
  • In Claude for Desktop, go to Settings > Developer
  • Click "Edit Config"
  • Alternative Edit config approach using VSCode in Mac/Windows:
    # For Mac Users
    code ~/Library/Application\ Support/Claude/claude_desktop_config.json
    
    # For Windows Users
    code $env:AppData\Claude\claude_desktop_config.json
    
  • Add the file to config:
{
    "mcpServers": {
        "weather": {
            "command": "uv",
            "args": [
                "--directory",
                "/ABSOLUTE/PATH/TO/PARENT/FOLDER/wordpress",
                "run",
                "main.py"
            ]
        }
    }
}

The server provides these testable tools:

  • fetch_wordpress_info: Get basic site information
  • fetch_posts: Get recent posts
  • fetch_categories: List all categories
  • fetch_posts_by_category: Get posts in a specific category
  • fetch_pages: Get site pages
  • fetch_post_by_id: Get a specific post
  • fetch_page_by_id: Get a specific page

Error Handling

The server includes robust error handling for:

  • Invalid JSON responses
  • Network errors
  • WordPress API errors
  • Invalid URLs
  • API authentication issues

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.