Manage WordPress sites and create content with AI-generated featured images.
A Model Context Protocol (MCP) server that enables AI assistants to manage WordPress sites and create content with AI-generated featured images.
git clone https://github.com/seomentor/wpmcp.git
cd wpmcp
pip install -r requirements.txt
Edit config/wordpress_sites.yaml
:
sites:
- id: "site1"
name: "My WordPress Blog"
url: "https://myblog.com"
username: "your-username"
password: "your-app-password"
Create a .env
file:
OPENAI_API_KEY=your-api-key-here
⚠️ Important Note: If you have an OPENAI_API_KEY
already set in your Windows/Mac environment variables, it might override the one in .env
. To avoid conflicts:
OPENAI_API_KEY
from your system environment variables, ORAdd to Claude's config file:
Windows: %APPDATA%\Claude\claude_desktop_config.json
Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"wordpress": {
"command": "python",
"args": ["-m", "src.server"],
"cwd": "C:/path/to/wordpress-mcp-server"
}
}
}
Option 2: Include OpenAI API Key in Claude Config (Recommended if having issues)
{
"mcpServers": {
"wordpress": {
"command": "python",
"args": ["-m", "src.server"],
"cwd": "C:/path/to/wordpress-mcp-server",
"env": {
"OPENAI_API_KEY": "your-openai-api-key-here"
}
}
}
}
In Claude Desktop:
"Create an article about AI trends with an image on site1"
Command | Description | Example |
---|---|---|
List sites | Show all configured sites | "Show me all WordPress sites" |
Create article | Create a new post | "Create an article about Python on site1" |
Create with image | Create post with AI image | "Create article with image about space on blog1" |
Test connection | Verify site access | "Test connection to site1" |
Get categories | List site categories | "Show categories on site1" |
Get tags | List site tags | "Show tags on site1" |
Enable REST API (enabled by default in WordPress 5.0+)
Create Application Password:
Required Permissions:
edit_posts
- Create and edit postsupload_files
- Upload mediamanage_categories
- Create categoriesmanage_post_tags
- Create tagsThe server uses OpenAI's DALL-E 3 for automatic image generation:
OPENAI_API_KEY=sk-... # OpenAI API key for image generation
settings:
default_post_status: "draft" # draft, publish, private
default_post_format: "standard"
max_retries: 3
timeout: 30
Run the diagnostic script to check your setup:
python scripts/diagnose.py
This will check:
"Server disconnected"
"Image generation failed"
OPENAI_API_KEY
in system environment variables"Authentication failed"
Contributions are welcome! Please feel free to submit a Pull Request.
git checkout -b feature/AmazingFeature
)git commit -m 'Add some AmazingFeature'
)git push origin feature/AmazingFeature
)This project is licensed under the MIT License - see the LICENSE file for details.
Made with ❤️ by Shay Amos for WordPress developers, SEO`s and AI enthusiasts
Visit my website for more cool apps :) https://www.seomentor.co.il
Automate browser actions using natural language commands. Powered by Playwright and supports multiple LLM providers.
Parses invoice data, uploads it to Google Sheets, and answers queries by fetching information from the sheet.
Automate desktop actions like mouse control, keyboard input, and taking screenshots.
Provides Taiwan national holidays and compensatory workday information. Data is fetched and cached automatically.
Connect AI assistants to Limitless to access personal memory and lifelog data.
Connect your AI Agents to 8,000 apps instantly.
Manage complex AI agent workflows with a Kanban-based task management system.
Reads EndNote .enl libraries and exposes their contents through the MCP interface.
Query and search for issues in Linear, a project management tool.
Manages configurations for MCP clients, automatically detecting file paths based on OS and client.