Claudeus WordPress管理
STDIOAI驱动的WordPress管理系统
AI驱动的WordPress管理系统
"Unleash the Power of AI in Your WordPress Realm - Setting the Standard for MCP Excellence!" 🖤
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! 🤯
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! ❤️
Traditional WordPress → 😫 Hours of manual work
Claudeus WP MCP → 🚀 INSTANT RESULTS!
Content Creation: 4 hours → 30 minutes
SEO Optimization: 2 hours → 15 minutes
Bulk Updates: 8 hours → 45 minutes
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! 🎸
If you're using Claude Desktop, you only need to:
wp-sites.json file# Required Software Node.js ≥ 22.0.0 TypeScript ≥ 5.0.0 PNPM WordPress site with REST API
# Clone the repository git clone https://github.com/deus-h/claudeus-wp-mcp # Install dependencies pnpm install # Build the project pnpm build # Configure Claude Desktop cp claude_desktop_config.json.example claude_desktop_config.json # Edit claude_desktop_config.json with your settings
# Copy example configs cp .env.example .env cp wp-sites.json.example wp-sites.json # Edit .env and wp-sites.json with your settings
The wp-sites.json file is used to configure your WordPress sites for integration. Below is an example structure:
{ "site-alias": { "URL": "https://your-wordpress-site.com", "USER": "username", "PASS": "application-password", "authType": "basic" // or "jwt" } }
wp-sites.json file.Ensure that your wp-sites.json file is kept secure and not shared publicly.
The wp-sites.json file allows you to manage multiple WordPress sites seamlessly. Here's how you can set it up:
{ "default_test": { "URL": "https://test.yourdomain.se", "USER": "admin", "PASS": "Hn5K pL8x Wm2j Vt9q Bc4y Rs7D", "authType": "basic" }, "live": { "URL": "https://our-live-site.se", "USER": "deus", "PASS": "Kj9P mN2x vR4h Zt8L wQ5y Bc3M", "authType": "basic" }, "test": { "URL": "https://our-test-site.se", "USER": "deus", "PASS": "Yw7H fT6n Jm5k Vd9x Pg4q Ls2B", "authType": "basic" }, "client1_live": { "URL": "https://client1-live-site.se", "USER": "deus", "PASS": "Xc8D bN4v Ht6m Rk2p Zj9w Qf5L", "authType": "basic" }, "client1_test": { "URL": "https://client1-test-site.se", "USER": "deus", "PASS": "Gm7B sW3x Yn5h Kt9q Vf4c Pd2L", "authType": "basic" } }
live, test, client1_live). This allows you to easily switch between different environments or client sites.basic or jwt.This setup allows you to efficiently manage multiple WordPress sites from a single configuration file, streamlining your workflow and enhancing productivity.
# Start the MCP Inspector UI pnpm inspector # This will: # 1. Build the project # 2. Launch the Inspector UI # 3. Open your browser at http://localhost:5173
Connect to Server
Available Features
Testing Prompts
create-blog-post with your ideasanalyze-post-seobulk-update-postsManaging Resources
Using Tools
🤘 Pro Tip: Use the Inspector tab to see real-time communication between the UI and server!
The Claude Desktop configuration file can be found at:
~/Library/Application Support/Claude/claude_desktop_config.json%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:
mcpServers objectFor 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!
Add this to your claude_desktop_config.json:
{ "mcpServers": { "claudeus-wp-mcp": { "command": "npx", "args": [ "-y", "claudeus-wp-mcp" ], "env": { "WP_SITES_PATH": "/absolute/path/to/your/wp-sites.json" } } } }
{ "mcpServers": { "claudeus-wp-mcp": { "command": "docker", "args": [ "run", "-i", "--rm", "--network=host", "--mount", "type=bind,src=/absolute/path/to/your/wp-sites.json,dst=/app/wp-sites.json", "--mount", "type=bind,src=/absolute/path/to/your/.env,dst=/app/.env", "mcp/wordpress", "--config", "/app/wp-sites.json" ] } } }
🎸 Pro Tip: Make sure to replace
/absolute/path/to/your/wp-sites.jsonwith the actual path to your configuration file!
If the server isn't showing up in Claude:
claude_desktop_config.json syntax~/Library/Logs/Claude%APPDATA%\Claude\logsClaudeus 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 |
| Feature | Description |
|---|---|
| Posts | Create, update, analyze |
| Pages | Full page management |
| Media | Handle all media types |
| SEO | AI-powered optimization |
| Feature | Description |
|---|---|
| Content Generation | AI-written posts |
| SEO Analysis | Smart optimization |
| Bulk Operations | Mass updates |
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! 🤘🖤
src/ ├── api/ # WordPress API integration layer │ ├── client/ # WordPress REST API client │ ├── endpoints/ # Endpoint definitions & handlers │ └── types/ # WordPress API type definitions │ ├── mcp/ # MCP protocol implementation │ ├── server.ts # Core MCP server implementation │ ├── transport/ # Transport layer handlers │ ├── tools.ts # Tool registration & management │ └── types/ # MCP protocol type definitions │ ├── security/ # Security framework │ ├── auth/ # Authentication handlers │ ├── validation/ # Input validation │ └── encryption/ # Data encryption utilities │ ├── tools/ # Tool implementations │ ├── content/ # Content management tools │ ├── media/ # Media handling tools │ ├── shop/ # WooCommerce integration │ └── system/ # System management tools │ └── prompts/ # AI prompt templates ├── content/ # Content generation prompts ├── seo/ # SEO analysis prompts └── shop/ # E-commerce prompts
| 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 |
| 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 |
| 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 |
| 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 |
| 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 |
| 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! ❤️
| 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% |
| 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 | $3500/month | All services combined |
| Claude Pro | $20/month | At Anthropic |
| Difference | $3,480/month | Potential Savings using Claudeus WordPress MCP with Claude Desktop (Mac, Windows) |
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 comes great responsibility" - Uncle Ben
The Claudeus WordPress MCP is a powerful tool that can:
But remember:
wp-sites.json is experimental{ "capabilities": { "discovery": { "claudeus_wp_discover_endpoints": true }, "posts": { "claudeus_wp_content__get_posts": true, "claudeus_wp_content__create_post": true, "claudeus_wp_content__update_post": true, "claudeus_wp_content__delete_post": false } // ... other capabilities } }
We're actively working on:
🎸 Pro Tip: Use GitHub Discussions to share your experience, report issues, or suggest improvements!
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:
Our testing framework is built with precision and reliability in mind, just like a well-tuned guitar! 🎸
# Run all tests pnpm test # Run specific test suite pnpm test:unit pnpm test:integration # Run with coverage pnpm test:coverage
⚠️ 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:
git checkout -b feature/AmazingFeature)git commit -m '🎸 Add some AmazingFeature')git push origin feature/AmazingFeature)All team members must adhere to:
If you're interested in joining the SimHop MCP Development Team:
🔥 Pro Tip: Team members should always run the test suite before submitting a PR!
MIT License - Rock on!
| Tool Name | Category | Capabilities | Danger Level |
|---|---|---|---|
| Content Management | |||
claudeus_wp_content__get_posts | Content | List all posts with filters | 🟢 Safe |
claudeus_wp_content__create_post | Content | Create new blog posts | 🟡 Moderate |
claudeus_wp_content__update_post | Content | Modify existing posts | 🟡 Moderate |
claudeus_wp_content__delete_post | Content | Remove posts | 🔴 High |
claudeus_wp_content__get_pages | Content | List all pages | 🟢 Safe |
claudeus_wp_content__create_page | Content | Create new pages | 🟡 Moderate |
claudeus_wp_content__update_page | Content | Modify existing pages | 🟡 Moderate |
claudeus_wp_content__delete_page | Content | Remove pages | 🔴 High |
claudeus_wp_content__get_blocks | Content | List reusable blocks | 🟢 Safe |
claudeus_wp_content__create_block | Content | Create reusable blocks | 🟡 Moderate |
claudeus_wp_content__update_block | Content | Modify blocks | 🟡 Moderate |
claudeus_wp_content__delete_block | Content | Remove blocks | 🔴 High |
| Media Management | |||
claudeus_wp_media__get_media | Media | List media files | 🟢 Safe |
claudeus_wp_media__upload | Media | Upload new media | 🟡 Moderate |
claudeus_wp_media__update | Media | Update media metadata | 🟡 Moderate |
claudeus_wp_media__delete | Media | Remove media files | 🔴 High |
| Theme Management | |||
claudeus_wp_theme__list | Theme | List available themes | 🟢 Safe |
claudeus_wp_theme__get_active | Theme | Show current theme | 🟢 Safe |
claudeus_wp_theme__activate | Theme | Switch active theme | 🔴 High |
claudeus_wp_theme__get_customization | Theme | View theme settings | 🟢 Safe |
claudeus_wp_theme__update_customization | Theme | Modify theme settings | 🟡 Moderate |
claudeus_wp_theme__get_custom_css | Theme | View custom CSS | 🟢 Safe |
claudeus_wp_theme__update_custom_css | Theme | Modify custom CSS | 🟡 Moderate |
| WooCommerce | |||
claudeus_wp_shop__get_products | Shop | List products | 🟢 Safe |
claudeus_wp_shop__get_orders | Shop | View orders | 🟢 Safe |
claudeus_wp_shop__get_sales | Shop | Access sales stats | 🟢 Safe |
| System | |||
claudeus_wp_discover_endpoints | System | List available endpoints | 🟢 Safe |
🤘 Pro Tip: Always test high-danger tools in a staging environment first!
Data manipulation tools in the Claudeus WordPress MCP are powerful and can significantly impact your WordPress sites. Here's what you need to know:
When used correctly, these tools can:
"With great power comes great responsibility." Use these tools wisely to harness their full potential while minimizing risks.
The following tools can create, update, or delete data on your WordPress site:
claudeus_wp_content__create_post: Create new blog postsclaudeus_wp_content__update_post: Update existing postsclaudeus_wp_content__delete_post: Delete postsclaudeus_wp_content__create_page: Create new pagesclaudeus_wp_content__update_page: Update existing pagesclaudeus_wp_content__delete_page: Delete pagesclaudeus_wp_content__create_block: Create reusable blocksclaudeus_wp_content__update_block: Update existing blocksclaudeus_wp_content__delete_block: Delete blocksclaudeus_wp_media__upload: Upload new media filesclaudeus_wp_media__update: Update media metadataclaudeus_wp_media__delete: Delete media itemsclaudeus_wp_theme__activate: Change active themeclaudeus_wp_theme__update_customization: Modify theme settingsclaudeus_wp_theme__update_custom_css: Update custom CSSUse these tools with caution to avoid unintended changes. Always:
"With great power comes great responsibility." Use these tools wisely to enhance your WordPress site while maintaining its integrity.
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:
This motivated us to create Claudeus WordPress MCP - not just as another WordPress management tool, but as a reference implementation that demonstrates:
While this remains a private repository, we've made the code available for viewing to:
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!
Amadeus Samiel H. (CTO/Lead Solutions Architect)
Simon Malki (CEO)
Stockholm HQ (Business & Strategy) 📍 Krögers Promenad 11, 191 37 Sollentuna
Norrköping Division (Technical Innovation) 📍 Klingsbergsgatan 13, 603 54 Norrköping
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:
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!" 🎸
"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)
npmis not a package manager, it's a repository of packages. If you want a dependable package manager, always usepnpm
— Amadeus Samiel H.
In code's vast land,
npm stands, a host,
But pnpm's hand,
Manages most.
With iron might,
Dependencies align,
pnpm's light,
In code, it shines.
A true manager's call,
In the coder's hall,
pnpm reigns,
Above them all.
Made with 🤘❤️ by Amadeus Samiel H.