wordpress-mcp-server

# WordPress MCP Server A Machine Communication Protocol (MCP) server that allows publishing content to WordPress sites. ## Features - Publish articles to WordPress - Test WordPress connection - Create, retrieve, and manage WordPress categories and tags - Automatically handle category and tag creation when publishing - Support for featured images via URL or base64-encoded data - Works as both standalone FastAPI server and MCP server - Environment variable support for WordPress credentials ## Setup 1. Create a virtual environment using UV: ``` uv venv .venv\Scripts\activate ``` 2. Install dependencies: ``` uv pip install -r requirements.txt ``` 3. Configure WordPress credentials: - Rename `.env.example` to `.env` (or create a new `.env` file) - Update with your WordPress site URL, username, and application password ## Usage ### As MCP Server Run the server in MCP mode: ``` python main.py --mcp ``` ### As Standalone API Run the server as a standalone FastAPI application: ``` python main.py ``` The API will be available at http://localhost:8000 ## API Endpoints - `GET /` - Root endpoint - `GET /wp-config` - Get WordPress configuration from environment variables - `POST /get-categories` - Get all categories from WordPress - `POST /get-tags` - Get all tags from WordPress - `POST /test-connection` - Test the WordPress connection - `POST /publish-article` - Publish an article to WordPress ## MCP Tools - `PUBLISH_ARTICLE` - Publish an article to WordPress with category and tag IDs - `PREPARE_ARTICLE_METADATA` - Check for existing categories and tags, create them if they don't exist, and return their IDs - `TEST_CONNECTION` - Test connection to WordPress site ## Category and Tag Management The WordPress MCP Server now supports advanced category and tag management: ### Using PREPARE_ARTICLE_METADATA This tool allows you to: 1. Check if categories and tags exist on your WordPress site 2. Automatically create any categories or tags that don't exist 3. Return the IDs of all categories and tags for use with PUBLISH_ARTICLE Example workflow: 1. Call PREPARE_ARTICLE_METADATA with category and tag names 2. Get back the corresponding IDs 3. Use those IDs with PUBLISH_ARTICLE to publish your content ## Featured Image Support The WordPress MCP Server now supports adding featured images to articles: ### Using PUBLISH_ARTICLE with Images You can add a featured image to your article in two ways: 1. **Via URL**: Provide an `image_url` parameter with a direct link to the image ``` "image_url": "https://example.com/path/to/image.jpg" ``` 2. **Via Base64**: Provide an `image_base64` parameter with the base64-encoded image data ``` "image_base64": "iVBORw0KGgoAAAANSUhEUgAA..." ``` 3. **Custom Filename**: Optionally specify a filename for the uploaded image ``` "image_filename": "my-custom-image-name.jpg" ``` The server will: - Download the image (if URL provided) or decode the base64 data - Upload the image to WordPress - Set it as the featured image for the article - Return the media ID in the response ### Using the Standalone API When using the standalone API, you can provide a featured image either as: - A file upload using the `image` form field - A URL using the `image_url` form field ## Environment Variable Support All tools now support using environment variables from your `.env` file as defaults: - `WP_SITE_URL` - Your WordPress site URL - `WP_USERNAME` - Your WordPress username - `WP_PASSWORD` - Your WordPress application password This means you can call the tools without explicitly providing these parameters if they're set in your environment.