Integrates with WooCommerce to handle products, orders, and sales data through dedicated tools like claudeus_wp_shop__get_products, claudeus_wp_shop__get_orders, and claudeus_wp_shop__get_sales
Allows AI-powered WordPress management including content creation, bulk operations, SEO optimization, WooCommerce management, and multi-site orchestration
🤘 Claudeus WordPress MCP 🎸
"Unleash the Power of AI in Your WordPress Realm - Setting the Standard for MCP Excellence!" 🖤
🌟 Unleash Your WordPress Superpowers!
Are you tired of the endless grind of WordPress management? Drowning in content creation, SEO optimization, and site maintenance? Get ready to experience something that will blow your mind! 🤯
🎸 Meet Your New WordPress Superpower 🖤
Claudeus WordPress MCP isn't just another WordPress tool – it's your personal WordPress wizard, powered by cutting-edge AI and crafted with the precision of a metal guitarist's sweep picking! This isn't just automation; it's liberation! ❤️
⚡ What Makes It Epic?
Content Creation on Steroids: Generate engaging, SEO-optimized blog posts ✓ READY
Bulk Operations at Light Speed: Manage hundreds of posts across multiple sites ✓ READY
AI-Powered SEO Magic: Let AI analyze and optimize your content ✓ READY
WooCommerce Mastery: Handle products, orders, and sales ✓ READY
Multi-Site Orchestra: Conduct multiple WordPress sites ✓ READY
💥 Why Developers Are Going Crazy
🎯 Imagine Being Able To...
Create weeks of content in minutes ✓
Analyze and optimize your entire site's SEO instantly ✓
Manage multiple client sites with supernatural efficiency ✓
Handle WooCommerce operations at lightning speed ✓
All while your competition is still logging into WordPress! ✓
🔮 The Future of WordPress is Here
This isn't just a tool – it's your ticket to WordPress enlightenment. Whether you're a solo developer, agency owner, or WordPress enthusiast, Claudeus WordPress MCP gives you superpowers that will make your competition's jaws drop!
"I've seen the future of WordPress management, and it's absolutely metal! 🤘❤️" - Every Developer After Using Claudeus WP MCP
Ready to transform your WordPress workflow from a garage band to a stadium-filling metal symphony? Let's rock! 🎸
📖 Quick Start Guide
Using with Claude Desktop
If you're using Claude Desktop, you only need to:
Configure Claude Desktop integration (see "Claude Desktop Integration" section)
Create and configure your
wp-sites.json
fileRock on! 🤘
Full Installation (for development)
2. Installation
3. Configuration
Configuring wp-sites.json
The wp-sites.json
file is used to configure your WordPress sites for integration. Below is an example structure:
URL: The URL of your WordPress site.
USER: The username for authentication.
PASS: The application password for secure access.
authType: The authentication type, either "basic" or "jwt".
Obtaining the Application Password
Log in to your WordPress Admin Dashboard.
Navigate to Users > Profile.
Scroll down to the Application Passwords section.
Enter a name for the application and click "Add New".
Copy the generated password and use it in your
Ensure that your wp-sites.json
file is kept secure and not shared publicly.
Multi-Site Configuration
The wp-sites.json
file allows you to manage multiple WordPress sites seamlessly. Here's how you can set it up:
Example Structure
Logic and Usage
Site Aliases: Each site is identified by a unique alias (e.g.,
live
,test
,client1_live
). This allows you to easily switch between different environments or client sites.URL: The base URL for each WordPress site.
USER: The username used for authentication.
PASS: The application password for secure access.
authType: Defines the authentication method, either
basic
orjwt
.
How to Use
Define Multiple Sites: Add as many site configurations as needed, each with a unique alias.
Switch Between Sites: Use the alias to select the desired site for operations.
Secure Access: Ensure that each site has a valid application password and secure authentication method.
Environment Management: Easily manage different environments (e.g., live, test) for each client.
This setup allows you to efficiently manage multiple WordPress sites from a single configuration file, streamlining your workflow and enhancing productivity.
4. Rock and Roll with MCP Inspector! 🎸
Exploring with Inspector UI
Connect to Server
Click "Connect" in the top-right corner
Select "Local Server" for development
Available Features
🎸 Prompts: Test AI content generation
🛠 Tools: Manage WordPress operations
📦 Resources: Browse WordPress sites
🔍 Inspector: Debug server communication
Testing Prompts
Select "Prompts" tab
Try
create-blog-post
with your ideasAnalyze SEO with
analyze-post-seo
Bulk update with
bulk-update-posts
Managing Resources
Browse connected WordPress sites
View site details and capabilities
Test API endpoints directly
Using Tools
Create and update content
Manage media files
Run bulk operations
🤘 Pro Tip: Use the Inspector tab to see real-time communication between the UI and server!
🎮 Claude Desktop Integration
Configuration Location
The Claude Desktop configuration file can be found at:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.json
Windows:
%APPDATA%\Claude\claude_desktop_config.json
⚠️ IMPORTANT: If you already have other MCP servers configured in Claude Desktop, DO NOT directly copy our example file as it will overwrite your existing configuration! Instead:
For existing Claude Desktop users:
Open your existing config through Claude Desktop:
Click on the Claude menu
Select "Settings..."
Click on "Developer" in the lefthand bar
Click on "Edit Config"
OR open your config file directly in a text editor
Add our Claudeus WordPress MCP server configuration to your existing
mcpServers
object
For new Claude Desktop users: You can copy our example config file:
# For macOS cp /Users/amadeus/code/claudeus/servers/claudeus-wp-mcp/claude_desktop_config.json.example ~/Library/Application\ Support/Claude/claude_desktop_config.json # For Windows (in PowerShell) Copy-Item claude_desktop_config.json.example $env:APPDATA\Claude\claude_desktop_config.json
🎸 Pro Tip: Our example config file comes pre-configured with the optimal settings - just update the path to your
wp-sites.json
!
Usage with Claude Desktop
Add this to your claude_desktop_config.json
:
NPX Setup
Docker Setup 🐳
🎸 Pro Tip: Make sure to replace
/absolute/path/to/your/wp-sites.json
with the actual path to your configuration file!
After Configuration
Restart Claude Desktop completely
Look for the hammer 🔨 icon in the bottom right corner of the input box
Click it to see available WordPress management tools
Start shredding! 🤘
Troubleshooting
If the server isn't showing up in Claude:
Verify your
claude_desktop_config.json
syntaxEnsure file paths are absolute and valid
Check Claude's logs at:
macOS:
~/Library/Logs/Claude
Windows:
%APPDATA%\Claude\logs
🎯 What is This?
Claudeus WordPress MCP is your ultimate AI-powered WordPress management system. It's like having a metal band's precision and power, but for your WordPress sites!
Feature | Description |
🤖 AI Integration | Direct communication with AI models |
🚀 Automation | Automate repetitive tasks |
🔒 Security | Enterprise-grade security |
⚡ Performance | Lightning-fast operations |
🌐 Multi-site | Manage multiple WP instances |
💪 Core Features
1. Content Management
Feature | Description |
Posts | Create, update, analyze |
Pages | Full page management |
Media | Handle all media types |
SEO | AI-powered optimization |
2. AI Capabilities
Feature | Description |
Content Generation | AI-written posts |
SEO Analysis | Smart optimization |
Bulk Operations | Mass updates |
🛠 Technical Deep Dive
Architecture 🏗️
Welcome to the backstage of our metal symphony! Each component is like an instrument in our technical orchestra, working together to create the most epic WordPress management system ever! 🤘🖤
Directory Structure 🎸
Core Components 🤘
Component | Responsibility | Key Features |
API Layer | WordPress Integration | REST client, Type safety, Rate limiting |
MCP Protocol | Communication | JSON-RPC 2.0, Bi-directional flow |
Security | Protection | Auth, Encryption, Validation |
Tools | Operations | Content, Media, WooCommerce |
Prompts | AI Integration | Templates, Context awareness |
Technical Amplification 🎸
Feature | Implementation | Description |
Type Safety | TypeScript | Full static typing, Runtime validation |
API Handling | REST/JSON-RPC | Efficient request/response handling |
Event System | EventEmitter | Async event processing |
Error Handling | Multi-layer | Comprehensive error management |
Caching | In-memory/Redis | Performance optimization |
Security Measures 🛡️
Layer | Protection | Features |
Transport | TLS/SSL | Encrypted communication |
Authentication | JWT/OAuth | Secure token management |
Validation | Schema-based | Input/Output validation |
Encryption | AES-256 | Data protection |
Audit | Comprehensive | Activity tracking |
Performance Tuning 🚀
Optimization | Technique | Description |
Caching | Multi-level | Response & Query caching |
Batching | Request grouping | Reduced API calls |
Compression | GZIP/Brotli | Network optimization |
Query Optimization | Smart fetching | Efficient DB queries |
Load Balancing | Distribution | Scale handling |
Error Categories & Handling 🎸
Category | Code Range | Handling | Example |
Protocol | -32600 to -32603 | Auto-retry | Invalid JSON-RPC |
WordPress | 1000-1999 | Fallback | API timeout |
Security | 2000-2999 | Alert | Auth failure |
Tools | 3000-3999 | Recover | Operation fail |
System | 4000-4999 | Restart | Resource exhaustion |
Design Principles Power Chord 🤘
Principle | Description | Implementation |
Modularity | Loose coupling | Independent components |
Type Safety | Strong typing | TypeScript + Validation |
Security | Zero trust | Multi-layer protection |
Performance | Speed metal | Optimized operations |
🎸 Pro Tip: Like a well-tuned guitar, each component is precisely calibrated for maximum shredding capability! ❤️
🎸 The Power of MCP
Time Savings
Task | Without MCP | With MCP | Result |
Blog Post Creation | 4 hours | 4 mins | ✓ 98.3% |
SEO Optimization | 2 hours | 1 min | ✓ 99.2% |
Bulk Updates | 8 hours | 5 mins | ✓ 99.0% |
Content Analysis | 3 hours | 2 mins | ✓ 98.9% |
Cost Efficiency
Resource | Traditional Cost | Description |
Content Writer | $500/month | Professional content creation |
SEO Expert | $1000/month | SEO optimization & strategy |
Developer Time | $2000/month | Technical implementation |
TOTAL | All services combined | |
|
|
|
Claude Pro | At | |
|
|
|
Difference | Potential Savings using Claudeus WordPress MCP
with Claude Desktop ( , ) | |
|
|
|
Claudeus Solution: All these capabilities for just $20/month with Claude Pro subscription
Total Monthly Savings: $3,480 (99.4% reduction) ❤️
🎸 Pro Tip: One Claude Pro subscription replaces multiple expensive services, turning your WordPress management from a costly orchestra into a lean, mean, Metal Machine! 🤘
⚡ With Great Power...
"With great power comes great responsibility" - Uncle Ben
The Claudeus WordPress MCP is a powerful tool that can:
Save hundreds of hours of manual work
Reduce operational costs by up to 85%
Improve content quality and consistency
Automate repetitive tasks
But remember:
Always review AI-generated content
Keep security best practices in mind
Monitor system usage and performance
Maintain backup strategies
Use the power responsibly! 🤘
⚠️ Issues and Considerations
Current Limitations and Workarounds
1. Claude Desktop Response Limits
Issue: Claude Desktop's maximum response length can be reached frequently during complex operations
Impact: Operations may be interrupted, requiring user intervention to continue
Workaround:
Configure Claude Desktop to break tasks into smaller batches
In Claude Desktop Settings > Advanced:
Set "Maximum Response Length" to a lower value
Enable "Auto-split Responses"
Use the Inspector UI for large-scale operations
2. Experimental Capabilities Control
Issue: The new capability control feature in
wp-sites.json
is experimentalStatus: Integrated but under testing
Example Configuration:
Considerations:
Use with caution in production environments
Test thoroughly in staging first
Consider contributing improvements (see Contributing section)
Default to basic configuration if unsure
3. Rate Limiting Considerations
Issue: WordPress REST API has rate limits
Impact: Bulk operations might be throttled
Mitigation:
Use batch processing features
Implement appropriate delays between requests
Monitor API response headers for rate limit info
4. Memory Management
Issue: Large operations can consume significant memory
Impact: Potential performance degradation
Best Practices:
Monitor system resources during large operations
Use pagination for large datasets
Implement cleanup routines
Future Improvements
We're actively working on:
Improved response handling in Claude Desktop
Stable release of capabilities control
Advanced rate limiting management
Memory optimization techniques
🎸 Support and Community ❤️
GitHub Discussions: Share ideas, report issues, and join the conversation
Documentation: Full technical docs
Examples: Sample implementations
🎸 Pro Tip: Use GitHub Discussions to share your experience, report issues, or suggest improvements!
🏗️ MCP Server Development Standards
Setting the Bar for Excellence
Claudeus WordPress MCP isn't just compliant with MCP standards - it defines them. Our implementation serves as a reference for developers building MCP servers, especially for Claude Desktop integration:
MCP Protocol Compliance
✅ Full MCP 2024-11-05 Spec Implementation
Complete capability declarations
Strict message format adherence
Proper transport handling (stdio/SSE)
Comprehensive error handling
Development Excellence
✅ TypeScript Best Practices
Strict mode enabled
Complete type coverage
Interface-driven development
✅ Testing Standards
95%+ test coverage
Comprehensive integration tests
Performance benchmarking
✅ Security First
Input validation
Rate limiting
Authentication flows
Vulnerability scanning
🧪 Testing Framework
Our testing framework is built with precision and reliability in mind, just like a well-tuned guitar! 🎸
Test Structure
Unit Tests: Comprehensive testing of individual components
Integration Tests: Ensuring components work together harmoniously
JSON-RPC Protocol Testing: Validating server-client communication
Custom Test Harness: Simulating real-world scenarios
Key Features
Custom Matchers: Enhanced Jest matchers for JSON-RPC validation
Test Transport Layer: Simulated transport for controlled testing
Async Operation Support: Extended timeouts for complex operations
Error Handling Tests: Comprehensive error scenario coverage
Running Tests
🤝 Contributing
⚠️ PRIVATE TEAM NOTICE ⚠️
This is a private repository maintained by the SimHop IT & Media AB development team. Contributions are limited to approved team members only. If you've been granted membership to the SimHop MCP Development Team, here's how to contribute:
For Approved Team Members
✓ Ensure you have the necessary repository access
✓ Follow our development workflow:
Create your feature branch (
git checkout -b feature/AmazingFeature
)Write and run tests for your changes
Maintain test coverage above 80%
Follow our coding standards and documentation requirements
✓ Testing Requirements:
Ensure all existing tests pass
Add new tests for your features
Run the full test suite before submitting
✓ Commit your changes (
git commit -m '🎸 Add some AmazingFeature'
)✓ Push to the branch (
git push origin feature/AmazingFeature
)✓ Create a Pull Request for review
Development Standards
All team members must adhere to:
TypeScript strict mode
ESLint configuration with team rules
Prettier for consistent formatting
JSDoc documentation for public APIs
Team security protocols
Internal code review processes
Getting Team Access
If you're interested in joining the SimHop MCP Development Team:
Contact our CTO: amadeus.hritani@simhop.se
Provide your development background and expertise
Complete the team onboarding process if approved
🔥 Pro Tip: Team members should always run the test suite before submitting a PR!
🤘 License
MIT License - Rock on!
🛠 MCP Tools Reference
Tool Categories and Danger Levels
Tool Name | Category | Capabilities | Danger Level |
Content Management | |||
| Content | List all posts with filters | 🟢 Safe |
| Content | Create new blog posts | 🟡 Moderate |
| Content | Modify existing posts | 🟡 Moderate |
| Content | Remove posts | 🔴 High |
| Content | List all pages | 🟢 Safe |
| Content | Create new pages | 🟡 Moderate |
| Content | Modify existing pages | 🟡 Moderate |
| Content | Remove pages | 🔴 High |
| Content | List reusable blocks | 🟢 Safe |
| Content | Create reusable blocks | 🟡 Moderate |
| Content | Modify blocks | 🟡 Moderate |
| Content | Remove blocks | 🔴 High |
Media Management | |||
| Media | List media files | 🟢 Safe |
| Media | Upload new media | 🟡 Moderate |
| Media | Update media metadata | 🟡 Moderate |
| Media | Remove media files | 🔴 High |
Theme Management | |||
| Theme | List available themes | 🟢 Safe |
| Theme | Show current theme | 🟢 Safe |
| Theme | Switch active theme | 🔴 High |
| Theme | View theme settings | 🟢 Safe |
| Theme | Modify theme settings | 🟡 Moderate |
| Theme | View custom CSS | 🟢 Safe |
| Theme | Modify custom CSS | 🟡 Moderate |
WooCommerce | |||
| Shop | List products | 🟢 Safe |
| Shop | View orders | 🟢 Safe |
| Shop | Access sales stats | 🟢 Safe |
System | |||
| System | List available endpoints | 🟢 Safe |
Danger Level Legend
🟢 Safe: Read-only operations, no data modification
🟡 Moderate: Creates or modifies content, but can be reverted
🔴 High: Destructive operations or system-wide changes
🤘 Pro Tip: Always test high-danger tools in a staging environment first!
⚠️ Warning: Use Data Manipulation Tools with Caution
Data manipulation tools in the Claudeus WordPress MCP are powerful and can significantly impact your WordPress sites. Here's what you need to know:
Potential Risks
Data Loss: Incorrect use of tools can lead to unintended data deletion or modification.
Site Downtime: Misconfigurations may cause site outages or performance issues.
Security Vulnerabilities: Improper handling of sensitive data can expose your site to security risks.
Best Practices
: Always create backups before operations
: Use staging environment for new tools
: Review changes before applying
: Restrict tool access to trusted users
: Track tool usage and performance
Constructive Use
When used correctly, these tools can:
✓ Automate repetitive tasks
✓ Enhance site performance
✓ Improve content quality
"With great power comes great responsibility." Use these tools wisely to harness their full potential while minimizing risks.
Data Manipulation Tools
The following tools can create, update, or delete data on your WordPress site:
Content Management
Posts:
claudeus_wp_content__create_post
: Create new blog postsclaudeus_wp_content__update_post
: Update existing postsclaudeus_wp_content__delete_post
: Delete posts
Pages:
claudeus_wp_content__create_page
: Create new pagesclaudeus_wp_content__update_page
: Update existing pagesclaudeus_wp_content__delete_page
: Delete pages
Blocks:
claudeus_wp_content__create_block
: Create reusable blocksclaudeus_wp_content__update_block
: Update existing blocksclaudeus_wp_content__delete_block
: Delete blocks
Media Management
claudeus_wp_media__upload
: Upload new media filesclaudeus_wp_media__update
: Update media metadataclaudeus_wp_media__delete
: Delete media items
Theme Customization
claudeus_wp_theme__activate
: Change active themeclaudeus_wp_theme__update_customization
: Modify theme settingsclaudeus_wp_theme__update_custom_css
: Update custom CSS
Use these tools with caution to avoid unintended changes. Always:
Back up your data before making changes
Test in a staging environment first
Review changes before applying them
Monitor the results after application
"With great power comes great responsibility." Use these tools wisely to enhance your WordPress site while maintaining its integrity.
🎯 Our Mission: Elevating MCP Development Standards
In the rapidly evolving landscape of AI-powered development, we observed a critical gap: many MCP servers, especially those designed for Claude Desktop, were falling short of professional development standards. Common issues included:
🔴 Poor TypeScript implementation or complete lack of type safety
🔴 Missing or inadequate test coverage
🔴 Incomplete MCP protocol implementation
🔴 Security vulnerabilities
🔴 Unreliable error handling
🔴 Lack of proper documentation
This motivated us to create Claudeus WordPress MCP - not just as another WordPress management tool, but as a reference implementation that demonstrates:
✅ Complete TypeScript coverage with strict type checking
✅ Comprehensive test suite (95%+ coverage)
✅ Full MCP 2024-11-05 specification compliance
✅ Enterprise-grade security practices
✅ Robust error handling and recovery
✅ Detailed documentation and examples
Why We're Setting the Standard
While this remains a private repository, we've made the code available for viewing to:
Demonstrate professional MCP server development practices
Encourage better standards in the MCP ecosystem
Show how to properly implement Claude Desktop integration
Provide a reference for secure WordPress automation
🏢 The Team Behind the Magic
SimHop IT & Media AB - Where Innovation Meets Metal 🤘
Based in the heart of Sweden, SimHop IT & Media AB is the powerhouse behind Claudeus WordPress MCP. We're not your typical tech company - we're a fusion of technical excellence and creative innovation, orchestrating digital solutions that rock!
🎸 The Maestros
Amadeus Samiel H. (CTO/Lead Solutions Architect)
MSc in Computer Science
20+ years crafting digital excellence
Instructor at LIU and other institutes
The technical virtuoso behind Claudeus WP MCP
Specializations: System Architecture, Creative Development, Technical Education
Simon Malki (CEO)
20+ years orchestrating business success
Expert in strategic planning and market dynamics
The business mastermind driving SimHop's vision
Specializations: Business Strategy, Market Analysis, Technical Operations
🏗️ Our Dual-Power Structure
Stockholm HQ (Business & Strategy) 📍 Krögers Promenad 11, 191 37 Sollentuna
Strategic Operations
Business Development
Market Strategy
Client Relations
Norrköping Division (Technical Innovation) 📍 Klingsbergsgatan 13, 603 54 Norrköping
Development & Architecture
Technical Innovation
R&D Operations
🤘 Why We Made It Free
Claudeus WordPress MCP was born from our passion for both heavy metal and heavy-duty WordPress development, but it represents something even more important: our commitment to elevating the standards of MCP server development. We observed that many existing MCP servers, especially those designed for Claude Desktop, were falling short of professional standards - lacking proper testing, type safety, and security measures.
By making our code available for viewing, we're not just sharing a tool - we're setting a new standard for MCP server development. Just as metal music pushes the boundaries of musical excellence, we're pushing the boundaries of what a properly implemented MCP server should be:
Technical Excellence: Like a perfectly executed guitar solo, our code demonstrates pristine TypeScript implementation
Comprehensive Testing: Every riff (function) is tested, every solo (feature) is verified
Security First: Protected like a fortress of metal, with proper authentication and validation
Documentation: Clear and detailed, like the best metal lyrics
While this remains a private repository, making the code viewable helps other developers understand how to properly implement MCP servers, especially for Claude Desktop integration. It's our way of saying "this is how it's done!" 🎸
🔥 Our Philosophy
Technical Excellence: Setting the standard for MCP development
Creative Innovation: Breaking boundaries while maintaining stability
Security First: Enterprise-grade protection by default
Continuous Evolution: Always pushing the technical boundaries
"We believe in empowering developers with tools that rock as hard as they do, while showing them how it should be done!" - Amadeus Samiel H. (aka Deus)
🧙♂️ Words of Wisdom
npm
is not a package manager, it's a repository of packages. If you want a dependable package manager, always usepnpm
— Amadeus Samiel H.
The Package Manager's Anthem
by Amadeus & Claude
In code's vast land,
With iron might,
A true manager's call,
Made with 🤘❤️ by
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A server enabling seamless interaction between AI models and WordPress sites with secure, standardized communication using the WordPress REST API for comprehensive site management.
- 🌟 Unleash Your WordPress Superpowers!
- 📖 Quick Start Guide
- 🎮 Claude Desktop Integration
- 🎯 What is This?
- 💪 Core Features
- 🛠 Technical Deep Dive
- 🎸 The Power of MCP
- ⚡ With Great Power...
- ⚠️ Issues and Considerations
- 🎸 Support and Community ❤️
- 🏗️ MCP Server Development Standards
- 🧪 Testing Framework
- 🤝 Contributing
- 🤘 License
- 🛠 MCP Tools Reference
- <span style="color: #A351D6">⚠️ Warning: Use Data Manipulation Tools with Caution</span>
- 🎯 Our Mission: Elevating MCP Development Standards
- 🏢 The Team Behind the Magic
- 🧙♂️ Words of Wisdom
Related Resources
Related MCP Servers
- AsecurityAlicenseAqualityThis server enables AI models to interact with MySQL databases through a standardized interface.Last updated -278114MIT License
- -securityAlicense-qualityEnables AI assistants to interact with WordPress sites through the WordPress REST API. Supports multiple WordPress sites with secure authentication, enabling content management, post operations, and site configuration through natural language.Last updated -25103MIT License
- -securityAlicense-qualityEnables AI assistants to interact with WordPress sites through the REST API. Supports multiple WordPress sites with secure authentication, enabling content management, post operations, and site configuration through natural language.Last updated -25MIT License
- AsecurityAlicenseAqualityA server that enables interaction with WordPress sites through REST API, allowing users to create, retrieve, and update posts using JSON-RPC 2.0 protocol.Last updated -321MIT License