mcp-wordpress

# 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): ```bash curl -LsSf https://astral.sh/uv/install.sh | sh ``` 2. Clone the repository: ```bash git clone <repository-url> cd wordpress ``` 3. Create and activate a virtual environment: ```bash uv venv source .venv/bin/activate # On Windows, use `.venv\Scripts\activate` ``` 4. Install dependencies using UV: ```bash uv add "mcp[cli]" httpx ``` ## Configuration 1. Create a `.env` file in the project root: ```bash WORDPRESS_URL="https://your-wordpress-site.com" ``` ## Usage Using Claude for Desktop: - First, start the server: ```bash 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