WordPress MCP Server

A Model Context Protocol (MCP) server that enables Claude AI to create and manage WordPress blog posts. Perfect for researchers, students, and professionals who want to document their work, share insights, and build a technical blog with AI assistance.

🚀 Features

Direct WordPress Integration: Create, update, and manage blog posts through Claude
Academic Focus: Built-in prompts for thesis documentation and research blogging
Flexible Deployment: Support for both Claude Desktop (stdio) and remote (HTTP) modes
Rich Content Support: Handle categories, tags, excerpts, and full HTML content
Port-Aware Configuration: Clean separation between WordPress (8000+) and MCP (9000+) ports
Type Safety: Full type hints and async/await support

📦 Installation

pip install wordpress-mcp-server

🎯 Quick Start

1. Install and Configure

# Install the package
pip install wordpress-mcp-server

# Test connection to your WordPress site
wordpress-mcp-server --test-connection --wordpress-url http://your-site.com

2. Claude Desktop Integration

Add to your Claude Desktop config (claude_desktop_config.json):

{
  "mcpServers": {
    "wordpress-blog": {
      "command": "wordpress-mcp-server",
      "args": ["--mode", "stdio"],
      "env": {
        "WORDPRESS_URL": "http://your-wordpress-site.com",
        "WORDPRESS_USERNAME": "your-username",
        "WORDPRESS_PASSWORD": "your-password"
      }
    }
  }
}

3. Start Blogging with Claude

Once configured, you can ask Claude to:

"Create a blog post about my research on Fast Fourier Transform algorithms"

"Write a thesis update documenting my progress with divide-and-conquer algorithms"

"List my recent blog posts and their status"

"Update post ID 15 with new findings from my experiments"

🔧 Configuration Options

Environment Variables

export WORDPRESS_URL="http://your-site.com"
export WORDPRESS_USERNAME="admin"
export WORDPRESS_PASSWORD="your-password"
export MCP_SERVER_PORT="9001"
export MCP_SERVER_MODE="stdio"

Command Line Options

# Basic usage
wordpress-mcp-server --mode stdio

# Custom WordPress URL and port
wordpress-mcp-server \
  --wordpress-url http://localhost:8888 \
  --mcp-port 9001 \
  --mode stdio

# HTTP mode for remote access
wordpress-mcp-server \
  --mode http \
  --host 0.0.0.0 \
  --mcp-port 9001

# Test connection
wordpress-mcp-server --test-connection

🎓 Perfect for Academic Blogging

Built-in Academic Prompts

The server includes specialized prompts for academic and research blogging:

Thesis Documentation

"Use the thesis_blog_post prompt to document my progress with:
- Topic: Machine Learning Algorithm Optimization
- Findings: Achieved 15% speed improvement with new caching strategy
- Challenges: Memory management issues with large datasets"

Algorithm Analysis

"Use the algorithm_analysis_post prompt for:
- Algorithm: Quicksort with median-of-three pivot selection
- Complexity: O(n log n) average case, O(n²) worst case
- Applications: Database indexing and real-time sorting systems"

Recommended Blog Structure

Weekly Progress Updates: Document research milestones and discoveries
Technical Deep Dives: Explain complex algorithms and implementations
Problem-Solving Sessions: Share debugging experiences and solutions
Literature Reviews: Summarize and analyze research papers
Code Showcases: Highlight implementations and optimizations

🛠️ Advanced Usage

Docker Deployment

# Clone and setup
git clone https://github.com/your-repo/wordpress-mcp-server
cd wordpress-mcp-server

# Build and run with Docker Compose
docker-compose up -d

# Or with custom configuration
docker run -e WORDPRESS_URL=http://your-site.com \
           -e WORDPRESS_USERNAME=admin \
           -e WORDPRESS_PASSWORD=secret \
           wordpress-mcp-server

Development Setup

# Clone repository
git clone https://github.com/your-repo/wordpress-mcp-server
cd wordpress-mcp-server

# Setup development environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -e .[dev]

# Run tests
pytest

# Run with development settings
wordpress-mcp-server --log-level DEBUG --test-connection

🔌 Available Tools

Blog Management Tools

Tool	Description	Parameters
`create_blog_post`	Create new blog post	title, content, status, excerpt, categories, tags
`update_blog_post`	Update existing post	post_id, title, content, status
`list_blog_posts`	List published/draft posts	status, per_page
`test_wordpress_connection`	Verify WordPress connectivity	none

Example Tool Usage

# Through Claude, you can:
"Create a blog post titled 'Understanding Big-O Notation' with content explaining
time complexity, add it to the 'Algorithms' category and tag it with 'computer-science',
'complexity-analysis', and 'education'"

"List my last 5 published posts to see what I've written recently"

"Update post ID 23 to change the status from draft to published"

🔒 Security Considerations

WordPress Credentials: Use WordPress Application Passwords instead of admin passwords
Network Access: Restrict MCP server access to trusted networks only
HTTPS: Use HTTPS for WordPress URLs in production
Firewall Rules: Configure appropriate firewall rules for port access

🐛 Troubleshooting

Common Issues

Connection Failed
# Test WordPress connection wordpress-mcp-server --test-connection # Check WordPress REST API curl http://your-site.com/wp-json/wp/v2/
Port Conflicts
# Check port usage netstat -an | grep :9001 # Use different port wordpress-mcp-server --mcp-port 9002
Permission Errors
- Ensure WordPress user has post creation permissions
- Check WordPress REST API is enabled
- Verify user roles and capabilities

Debug Mode

# Enable debug logging
wordpress-mcp-server --log-level DEBUG

# Log to file
wordpress-mcp-server --log-file wordpress-mcp.log

📋 Port Configuration

Service	Port Range	Default	Purpose
WordPress	8000-8999	8888	Web interface
MCP Server	9000+	9001	MCP protocol

This separation ensures clean network architecture and avoids port conflicts.

🤝 Contributing

Contributions are welcome! Please see our Contributing Guide for details.

Development Workflow

Fork the repository
Create a feature branch: git checkout -b feature/amazing-feature
Make changes and add tests
Run tests: pytest
Submit a pull request

📄 License

This project is licensed under the MIT License - see the LICENSE file for details.

🎉 Use Cases

For Students

Document thesis research progress
Create technical tutorials and explanations
Share project updates and insights
Build a professional portfolio

For Researchers

Publish research findings and methodologies
Create accessible explanations of complex topics
Document experimental results
Share literature reviews and analysis

For Developers

Write technical blog posts about algorithms
Document software development processes
Share coding insights and best practices
Create educational programming content

📚 Examples

Check out our examples directory for:

Sample Claude conversations
Blog post templates
Configuration examples
Integration patterns

🔗 Links

Made with ❤️ for the research and development community

Transform your research journey into engaging blog content with the power of AI assistance!