🤘 Claudeus WordPress MCP 🎸

🌟 让您的WordPress超级能力焕发光彩

🎸 迎接您的新WordPress超级能力 🖤

⚡ 它为何如此了不起？

• 增强的内容创作: 生成引人入胜且搜索引擎优化的博文 ✓ READY
• 极速批量操作: 管理多站点上的大量文章 ✓ READY
• AI驱动的SEO魔法: 使用AI分析并优化您的内容 ✓ READY
• WooCommerce精通: 处理商品、订单和销售 ✓ READY
• 多站点协调: 管理多个WordPress站点 ✓ READY

💥 开发者为何为之疯狂

传统WordPress → 😫 数小时手动工作
Claudeus WP MCP   → 🚀 即时结果！

内容创作: 4小时 → 30分钟
SEO优化: 2小时 → 15分钟
批量更新: 8小时 → 45分钟

🎯 畅想一下...

• 几分钟内创建数周的内容 ✓
• 即刻分析并优化整个网站的SEO ✓
• 以超自然的效率管理多个客户站点 ✓
• 以闪电般的速度处理WooCommerce操作 ✓
• 在您的竞争对手仍在登录WordPress时抓住先机 ✓

🔮 WordPress的未来已然来临

这不仅仅是一个工具——它是您通往WordPress启蒙的门票。无论您是独立开发者、机构所有者还是WordPress爱好者，Claudeus WordPress MCP为您提供超能力，使您的竞争对手为之瞠目结舌！

“我看到了WordPress管理的未来，它绝对是金属般炫酷的！🤘❤️” - 使用Claudeus WP MCP后的每位开发者

📖 快速入门指南

使用Claude Desktop

如果您正在使用Claude Desktop，您只需要：

1. 配置Claude Desktop集成（参见“Claude Desktop集成”部分）
2. 创建并配置您的wp-sites.json文件
3. 尽情摇滚吧！ 🤘

完整安装（用于开发）

# 必要的软件
Node.js ≥ 22.0.0
TypeScript ≥ 5.0.0
PNPM
具有REST API的WordPress站点

2. 安装

# 克隆代码仓库
git clone https://github.com/deus-h/claudeus-wp-mcp

# 安装依赖
pnpm install

# 构建项目
pnpm build

# 配置Claude Desktop
cp claude_desktop_config.json.example claude_desktop_config.json
# 编辑claude_desktop_config.json以设置相关内容

3. 配置

# 拷贝配置示例
cp .env.example .env
cp wp-sites.json.example wp-sites.json

# 编辑.env和wp-sites.json以进行设置

配置wp-sites.json

{
  "site-alias": {
    "URL": "https://your-wordpress-site.com",
    "USER": "username",
    "PASS": "application-password",
    "authType": "basic"  // 或 "jwt"
  }
}

• URL: 您的WordPress站点的URL。
• USER: 用于身份验证的用户名。
• PASS: 用于安全访问的应用密码。
• authType: 身份验证类型，"basic"或"jwt"。

获取应用密码

1. 登录到您的WordPress管理面板。
2. 导航到用户 > 个人信息。
3. 向下滚动到应用密码部分。
4. 输入应用的名称，然后点击“添加新项目”。
5. 复制生成的密码，并在wp-sites.json文件中使用。

多站点配置

示例结构

{
  "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）。这使您可以轻松切换不同环境或客户站点。
• URL: 每个WordPress站点的基本URL。
• USER: 用于身份验证的用户名。
• PASS: 用于安全访问的应用密码。
• authType: 定义身份验证方法，“basic”或“jwt”。

使用方法

1. 定义多个站点: 根据需要添加多个站点配置，每个都有唯一别名。
2. 切换站点: 使用别名选择所需站点进行操作。
3. 安全访问: 确保每个站点都有有效的应用密码和安全的身份验证方法。
4. 环境管理: 轻松管理每个客户的不同环境（例如，live, test）。

这种设置允许您从一个配置文件高效地管理多个WordPress站点，从而简化工作流程并提高生产力。

4. 使用MCP Inspector摇滚！ 🎸

# 启动MCP Inspector UI
pnpm inspector

# 这将:
# 1. 构建项目
# 2. 启动Inspector UI
# 3. 在浏览器中打开http://localhost:5173

使用Inspector UI探索

1. 连接到服务器
   • 点击右上角的"Connect"
   • 选择"Local Server"用于开发
2. 可用功能
   • 🎸 Prompts: 测试AI内容生成
   • 🛠 Tools: 管理WordPress操作
   • 📦 Resources: 浏览WordPress站点
   • 🔍 Inspector: 调试服务器通信
3. 测试Prompts
   • 选择"Prompts"标签
   • 使用您的想法尝试create-blog-post
   • 使用analyze-post-seo分析SEO
   • 使用bulk-update-posts进行批量更新
4. 管理资源
   • 浏览连接的WordPress站点
   • 查看站点详细信息及能力
   • 直接测试API端点
5. 使用工具
   • 创建并更新内容
   • 管理媒体文件
   • 运行批量操作

🤘 专业提示: 使用Inspector标签查看UI和服务器之间的实时通信！

🎮 Claude Desktop集成

配置位置

Claude Desktop配置文件可以在以下位置找到：

• macOS:

  ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows:

  %APPDATA%\Claude\claude_desktop_config.json

1. 对于现有Claude Desktop用户：
   • 通过Claude Desktop打开现有配置：
     • 点击Claude菜单
     • 选择“设置...”
     • 在左侧栏中选择“开发者”
     • 点击“编辑配置”
   • 或直接在文本编辑器中打开您的配置文件
   • 将我们的Claudeus WordPress MCP服务器配置添加到现有的mcpServers对象中
2. 对于新Claude Desktop用户： 您可以复制我们的示例配置文件：

   # 对于macOS
   cp /Users/amadeus/code/claudeus/servers/claudeus-wp-mcp/claude_desktop_config.json.example ~/Library/Application\ Support/Claude/claude_desktop_config.json
   
   # 对于Windows（在PowerShell中）
   Copy-Item claude_desktop_config.json.example $env:APPDATA\Claude\claude_desktop_config.json
   

🎸 专业提示: 我们的示例配置文件已预配置了最佳设置 - 只需更新wp-sites.json的路径即可！

在Claude Desktop中使用

NPX设置

{
  "mcpServers": {
    "claudeus-wp-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "claudeus-wp-mcp"
      ],
      "env": {
        "WP_SITES_PATH": "/absolute/path/to/your/wp-sites.json"
      }
    }
  }
}

Docker设置 🐳

{
  "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"
      ]
    }
  }
}

🎸 专业提示: 请确保用实际路径替换

/absolute/path/to/your/wp-sites.json

！

配置完成后

1. 完全重启Claude Desktop
2. 观察输入框右下角的锤子🔨图标
3. 点击它查看可用的WordPress管理工具
4. 尽情大显身手！🤘

疑难解答

如果服务器没有出现在Claude中：

1. 验证您的claude_desktop_config.json语法
2. 确保文件路径为绝对路径且有效
3. 检查Claude的日志：
   • macOS: ~/Library/Logs/Claude
   • Windows: %APPDATA%\Claude\logs

🎯 这是什么？

Claudeus WordPress MCP 是您终极的AI驱动WordPress管理系统。就像一支重金属乐队的精准和力量，但用于您的WordPress站点！

💪 核心特性

1. 内容管理

2. AI能力

🛠 技术深度

架构 🏗️

欢迎进入我们金属交响乐的后台！每一个组件就像是我们的技术乐团中的乐器，共同协作创造出有史以来最出色的WordPress管理系统！🤘🖤

目录结构 🎸

src/
├── api/              # WordPress API集成层
│   ├── client/       # WordPress REST API客户端
│   ├── endpoints/    # 端点定义和处理程序
│   └── types/        # WordPress API类型定义
│
├── mcp/              # MCP协议实现
│   ├── server.ts     # 核心MCP服务器实现
│   ├── transport/    # 传输层处理程序
│   ├── tools.ts      # 工具注册与管理
│   └── types/        # MCP协议类型定义
│
├── security/         # 安全框架
│   ├── auth/         # 身份验证处理程序
│   ├── validation/   # 输入验证
│   └── encryption/   # 数据加密工具
│
├── tools/            # 工具实现
│   ├── content/      # 内容管理工具
│   ├── media/        # 媒体处理工具
│   ├── shop/         # WooCommerce集成
│   └── system/       # 系统管理工具
│
└── prompts/          # AI提示模板
    ├── content/      # 内容生成提示
    ├── seo/          # SEO分析提示
    └── shop/         # 电子商务提示

核心组件 🤘

技术扩展 🎸

安全措施 🛡️

性能优化 🚀

错误分类与处理 🎸

设计原则与电源和弦 🤘

🎸 专业提示: 就像一把调音精准的吉他，每个组件都经过精确校准以发挥最大撕裂能力！❤️

🎸 MCP的力量

时间节省

成本效率

🎸 专业提示: 单独一个Claude Pro订阅就能取代多种昂贵的服务，将您的WordPress管理从昂贵的乐团转变为精简高效的金属机器！🤘

⚡ 巨大能力，附带责任

“能力越大，责任越大” - 本叔

Claudeus WordPress MCP 是一个强大的工具，可以：

• 节省数百小时的手工劳动
• 降低运营成本高达85%
• 提高内容质量和一致性
• 自动化重复性任务

但请记住：

1. 始终审查AI生成的内容
2. 保持安全最佳实践
3. 监控系统使用情况和性能
4. 维护备份策略
5. 负责任地使用能力！🤘

⚠️ 问题和考虑

当前限制与解决方案

1. Claude Desktop响应限制

• 问题: 在复杂操作中，Claude Desktop会频繁达到最大响应长度。
• 影响: 操作可能会被中断，需要用户干预才能继续。
• 解决方案:
  • 配置Claude Desktop以将任务分解为较小的批次。
  • 在Claude Desktop设置 > 高级中：
    • 将“最大响应长度”设置为较小值。
    • 启用“自动拆分响应”。
  • 对于大规模操作，使用Inspector UI。

2. 实验性功能控制

• 问题: wp-sites.json的新能力控制功能是实验性的。
• 状态: 已集成但正在测试。
• 配置示例：

  {
    "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
    }
  }
  

• 注意事项：
  • 在生产环境中使用时要小心。
  • 首先在登台环境中进行充分测试。
  • 考虑贡献改进（参见贡献部分）。
  • 如果不确定，请保留基础配置。

3. 速率限制考虑

• 问题: WordPress REST API有速率限制。
• 影响: 批量操作可能被限流。
• 缓解措施:
  • 使用批量处理功能。
  • 在请求之间实施适当的延迟。
  • 监控API响应头以获取速率限制信息。

4. 内存管理

• 问题: 大型操作可能会消耗大量内存。
• 影响: 性能可能会下降。
• 最佳实践：
  • 在大型操作期间监控系统资源。
  • 对大型数据集使用分页。
  • 实施清理例程。

未来改进

我们正在积极努力：

1. 改进Claude Desktop中的响应处理。
2. 发布稳定的能力控制版本。
3. 高级速率限制管理。
4. 内存优化技术。

🎸 支持与社区 ❤️

• GitHub 讨论：分享想法、报告问题并加入讨论。
• 文档：完整的技术文档。
• 示例：示例实现。

🎸 专业提示: 使用GitHub Discussion分享您的体验，报告问题或提出改进建议！

🏗️ MCP 服务器开发标准

设定卓越的标准

Claudeus WordPress MCP 不仅符合MCP标准 - 它定义了这些标准。我们的实现是开发人员构建MCP服务器的参考，特别是用于Claude Desktop集成。

MCP 协议合规

• <span style="color: #00ff00">✅ 全面实施MCP 2024-11-05规范</span>
  • 完整的功能声明。
  • 严格的信息格式遵循。
  • 合适的传输处理（stdio/SSE）。
  • 全面的错误处理。

开发卓越

• <span style="color: #00ff00">✅ TypeScript最佳实践</span>
  • 启用严格模式。
  • 完整类型覆盖。
  • 面向接口的开发。
• <span style="color: #00ff00">✅ 测试标准</span>
  • 95% 以上的测试覆盖率。
  • 全面的集成测试。
  • 性能基准测试。
• <span style="color: #00ff00">✅ 安全优先</span>
  • 输入验证。
  • 速率限制。
  • 身份验证流程。
  • 漏洞扫描。

🧪 测试框架

我们的测试框架是为精确性和可靠性而构建的，就像一把调音精准的吉他！ 🎸

测试结构

• 单元测试: 对各个组件进行全面测试。
• 集成测试: 确保组件协同工作。
• JSON-RPC协议测试: 验证服务器-客户端通信。
• 自定义测试工具: 模拟真实世界场景。

关键特性

• 自定义匹配器: 扩展的Jest匹配器用于JSON-RPC验证。
• 测试传输层: 模拟传输以便控制测试。
• 异步操作支持: 扩展的超时时间以应对复杂操作。
• 错误处理测试: 全面的错误场景覆盖。

运行测试

# 运行所有测试
pnpm test

# 运行特定的测试套件
pnpm test:unit
pnpm test:integration

# 运行测试并获取覆盖率
pnpm test:coverage

🤝 开源贡献

这是一个由SimHop IT & Media AB开发团队维护的私人代码库。贡献仅限于经过批准的团队成员。如果您已获得加入SimHop MCP开发团队的资格，请按以下步骤贡献：

对于已批准的团队成员

1. <span style="color: #00ff00">✓ 确保您具备所需的代码库访问权限</span>
2. <span style="color: #00ff00">✓ 遵循我们的开发流程:</span>
   • 创建您的功能分支 (

     git checkout -b feature/AmazingFeature

     )
   • 编写测试并运行测试以验证您的更改
   • 保持测试覆盖率在80%以上
   • 遵循我们的代码标准和文档要求
3. <span style="color: #00ff00">✓ 测试要求:</span>
   • 确保所有现有测试通过。
   • 为您的功能添加新测试。
   • 在提交之前运行完整的测试套件。
4. <span style="color: #00ff00">✓ 提交您的更改 (

   git commit -m '🎸 Add some AmazingFeature'

   )</span>
5. <span style="color: #00ff00">✓ 推送到分支 (

   git push origin feature/AmazingFeature

   )</span>
6. <span style="color: #00ff00">✓ 创建Pull Request以供审查</span>

开发标准

所有团队成员必须遵循：

• 启用TypeScript严格模式
• 使用团队规则配置ESLint
• 使用Prettier进行一致性格式化
• 为公共API编写JSDoc文档
• 遵循团队的安全协议
• 内部代码审查流程

获取团队访问权限

如果您有兴趣加入SimHop MCP开发团队：

1. 联系我们的CTO: amadeus.hritani@simhop.se
2. 提供您的开发背景和专业技能
3. 如果获得批准，完成团队入职流程

🔥 专业提示: 团队成员提交PR前应始终运行测试套件！

🤘 许可证

MIT License - 尽情摇滚！

🛠 MCP工具参考

工具类别和危险等级

claudeus_wp_content__get_posts

claudeus_wp_content__create_post

claudeus_wp_content__update_post

claudeus_wp_content__delete_post

claudeus_wp_content__get_pages

claudeus_wp_content__create_page

claudeus_wp_content__update_page

claudeus_wp_content__delete_page

claudeus_wp_content__get_blocks

claudeus_wp_content__create_block

claudeus_wp_content__update_block

claudeus_wp_content__delete_block

claudeus_wp_theme__get_customization

claudeus_wp_theme__update_customization

claudeus_wp_theme__get_custom_css

claudeus_wp_theme__update_custom_css

claudeus_wp_shop__get_products

claudeus_wp_discover_endpoints

危险等级说明

• 🟢 安全: 只读操作，不修改数据。
• 🟡 中等: 创建或修改内容，但可恢复。
• 🔴 高: 破坏性操作或系统范围的变更。

🤘 专业提示: 始终在登台环境中先测试高危险工具！

⚠️ 警告：谨慎使用数据操作工具

Claudeus WordPress MCP中的数据操作工具功能强大，可以显著影响您的WordPress站点。以下是您需要了解的重要事项：

潜在风险

• 数据丢失: 错误使用工具可能导致意外的数据删除或修改。
• 站点停机: 配置错误可能导致站点停机或性能问题。
• 安全漏洞: 不当处理敏感数据可能暴露您的站点于安全风险。

最佳实践

1. 🏃‍♂️ 安全第一：务必在操作前创建备份。
2. 🏃‍♂️ 测试安全：在登台环境中使用新工具。
3. 🏃‍♂️ 验证：在应用更改前进行审阅。
4. 🏃‍♂️ 确保安全：仅限可信用户使用工具。
5. 🏃‍♂️ 监控：跟踪工具的使用情况及性能。

建设性使用

正确使用时，这些工具可以：

• 🏃‍♂️ 自动化重复任务。
• 🏃‍♂️ 提升站点性能。
• 🏃‍♂️ 提高内容质量。

"肩负重任，使用这些工具明智地挖掘其巨大潜力，同时最大程度地降低风险。"

数据操作工具

以下工具可以在您的WordPress站点上创建、更新或删除数据：

内容管理

• 文章：

  • claudeus_wp_content__create_post

    : 创建新的博客文章。

  • claudeus_wp_content__update_post

    : 更新现有文章。

  • claudeus_wp_content__delete_post

    : 删除文章。
• 页面：

  • claudeus_wp_content__create_page

    : 创建新的页面。

  • claudeus_wp_content__update_page

    : 更新现有页面。

  • claudeus_wp_content__delete_page

    : 删除页面。
• 区块：

  • claudeus_wp_content__create_block

    : 创建可重用区块。

  • claudeus_wp_content__update_block

    : 更新现有区块。

  • claudeus_wp_content__delete_block

    : 删除区块。

媒体管理

• claudeus_wp_media__upload: 上传新的媒体文件。
• claudeus_wp_media__update: 更新媒体元数据。
• claudeus_wp_media__delete: 删除媒体项。

主题定制

• claudeus_wp_theme__activate: 更换活动主题。

• claudeus_wp_theme__update_customization

  : 修改主题设置。

• claudeus_wp_theme__update_custom_css

  : 更新自定义CSS。

谨慎使用这些工具以避免意外更改。始终：

1. 在进行更改之前备份您的数据。
2. 先在登台环境中测试。
3. 在应用之前审查更改。
4. 监控应用后的结果。

"肩负重任，使用这些工具明智地挖掘其巨大潜力，同时最大程度地降低风险。"

🎯 我们的任务：提升MCP开发标准

在迅速发展的AI驱动开发领域，我们观察到一个关键的缺口：许多MCP服务器，特别是设计用于Claude Desktop的那些，未能达到专业开发标准。常见问题包括：

• 🔴 糟糕的TypeScript实现或完全缺乏类型安全性。
• 🔴 缺漏或不足的测试覆盖。
• 🔴 不完整的MCP协议实现。
• 🔴 存在安全漏洞。
• 🔴 不可靠的错误处理。
• 🔴 缺乏合适的文档。

这促使我们创建Claudeus WordPress MCP——不仅仅是另一个WordPress管理工具，更是一个展示专业级MCP服务器开发标准的参考实现。我们提供的代表：

• ✅ 完全的TypeScript覆盖，启用严格类型检查。
• ✅ 全面的测试套件（95%+覆盖率）。
• ✅ 完全符合MCP 2024-11-05规范。
• ✅ 企业级安全实践。
• ✅ 稳健的错误处理和恢复。
• ✅ 详细的文档和示例。

我们为什么设定标准

虽然这是一个私人代码库，但我们将代码开放查看，以便：

1. 展示专业MCP服务器开发实践。
2. 鼓励MCP生态系统中的更高标准。
3. 展示如何正确实施Claude Desktop集成。
4. 为安全的WordPress自动化提供参考。

🏢 魔法背后的团队

SimHop IT & Media AB——创新与金属音乐的结合 🤘

SimHop IT & Media AB总部位于瑞典，是Claudeus WordPress MCP的幕后实力。我们并不是典型的科技公司——我们是技术卓越与创意创新的融合，统筹摇滚的数字解决方案！

🎸 创作大师

• 计算机科学硕士
• 20年以上数字卓越体验的塑造
• LIU及其他机构的讲师
• Claudeus WP MCP背后的技术大厨
• 专长：系统架构、创意开发、技术教育

• 20年以上业务成功的统筹经验
• 战略规划与市场动态专家
• 引领SimHop远景的商业大师
• 专长：商业战略、市场分析、技术运营

🏗️ 我们的双重力量结构

• 战略运营
• 业务发展
• 市场策略
• 客户关系

• 开发与架构
• 技术创新
• 研发运营

🤘 为什么我们免费提供

Claudeus WordPress MCP来自于我们对重金属和高强度WordPress开发的热情，但它代表着更为重要的东西：我们对提升MCP服务器开发标准的承诺。我们观察到，许多现有的MCP服务器，特别是那些为Claude Desktop设计的，未能达到专业标准——缺乏适当的测试、类型安全和安全措施。

通过使我们的代码公开查看，我们不仅在共享工具——我们在为MCP服务器开发设定新的标准。正如金属音乐突破音乐卓越的界限一样，我们正在推动适当实现MCP服务器的界限：

• 技术卓越：像执行精确的吉他独奏，我们的代码展示了纯净的TypeScript实现。
• 全面测试：每段节奏（功能）经过测试，每个独奏（功能）经过验证。
• 安全性优先：像一个金属堡垒般受保护，具有适当的身份验证和验证。
• 文档：清晰且详细，像最佳的金属歌词。

虽然这是一个私人代码库，但开放查看代码帮助其他开发者理解如何正确实施MCP服务器，尤其是在Claude Desktop集成。是我们宣布“这就是正确的方法！” 🎸

🔥 我们的哲学

1. 技术卓越：设定MCP开发的标准。
2. 创意创新：突破界限同时保持稳定。
3. 安全优先：默认的企业级保护。
4. 持续演进：始终推动技术边界。

"我们相信赋予开发者像他们一样出色的工具，同时向他们展示正确的实现方式！" - Amadeus Samiel H. (aka Deus)

🧙‍♂️ 智慧的话语

npm不是包管理器，它是一个包库。如果您想要一个可靠的包管理器，请始终使用pnpm
— Amadeus Samiel H.

包管理者的颂歌

by Amadeus & Claude

由 <span style="color: #A351D6">Amadeus Samiel H.</span> 制作 🤘❤️