STARWARCLOUD STARWAR.AI
返回市场
克劳德-us-wp-mcp服务器

克劳德-us-wp-mcp服务器

作者：deus-h79 星标更新：2025-11-12
安装使用来源：spider==github.com

项目介绍

<span style="color: #A351D6">🤘 Claudeus WordPress MCP</span> 🎸

"最全面的WordPress MCP服务器 - 145个工具，零妥协！" <span style="color: #000000">🖤</span>

License Node GitHub Stars ![NPM Version](https https://img.shields.io/npm/v/claudeus-wp-mcp.svg) MCP Standard

Claudeus WordPress MCP Server

🔥 完整的WordPress人工智能动力中心

145个生产就绪工具 覆盖WordPress管理的各个方面，从内容创建到站点健康监控，全部由人工智能驱动，并以企业级质量构建。

╔═══════════════════════════════════════════════════════╗
║         🎯 完整的WordPress覆盖 🎯            ║
╚═══════════════════════════════════════════════════════╝

✅ 内容管理          25个工具
✅ 媒体与资产        6个工具
✅ 分类法            12个工具
✅ 用户管理          10个工具
✅ 评论与审核        8个工具
✅ 菜单与导航        10个工具
✅ 全站编辑(FSE)     27个工具
✅ Astra Pro集成     11个工具
✅ 站点配置          15个工具
✅ 站点健康与诊断    8个工具
✅ 搜索与发现        5个工具
✅ WooCommerce       3个工具
✅ 系统发现          5个工具

📊 总计：145个生产就绪工具

⚡ 什么让它成为传奇？

🎸 完整的WordPress生态系统覆盖

  • 内容掌握：文章、页面、区块的完整CRUD操作，包括修订和自动保存
  • FSE动力中心：模板、全局样式、区块模式、导航
  • 主题控制：Astra Pro集成（超级菜单、自定义布局、设置）
  • 用户与访问：完整的用户管理，包括应用密码
  • 电子商务：WooCommerce产品、订单和销售管理
  • 站点健康：全面的诊断和监控
  • 通用搜索：AI驱动的内容发现，涵盖所有类型

💪 企业级架构

  • 类型安全：100% TypeScript，严格模式
  • 模块化设计：20多个专业模块，便于维护
  • 安全第一：输入验证、输出清理、认证
  • 性能：分页、缓存、批处理操作
  • 零错误：经过全面测试的生产就绪

🚀 为AI打造

  • Claude桌面集成：一流的MCP协议支持
  • AI驱动的工作流：智能内容生成与优化
  • 批量操作：同时自动化数百项任务
  • 上下文感知：AI理解您的WordPress结构

📊 完整工具清单

1. 内容管理 (25个工具)

文章、页面及区块

  • 读取：get_posts，get_post，get_pages，get_page，get_blocks，get_block
  • 创建：create_post，create_page，create_block
  • 更新：update_post，update_page，update_block
  • 删除：delete_post，delete_page，delete_block

修订与自动保存 (18个工具)

  • 文章修订：列出、获取、删除修订
  • 页面修订：列出、获取、删除修订
  • 区块修订：列出、获取、删除修订
  • 自动保存：获取/创建文章、页面、区块的自动保存

2. 媒体与资产 (6个工具)

  • get_media - 列出媒体库
  • get_media_item - 获取特定媒体
  • upload_media - 上传文件
  • update_media - 更新元数据
  • delete_media - 删除文件
  • update_alt_text - SEO优化

3. 分类法 (12个工具)

分类

  • get_categories，get_category，create_category，update_category，delete_category

标签

  • get_tags，get_tag，create_tag，update_tag，delete_tag

分类法发现

  • get_taxonomies，get_terms

4. 用户管理 (10个工具)

  • get_users，get_user，get_me
  • create_user，update_user，delete_user
  • create_app_password，list_app_passwords
  • revoke_app_password，introspect_password

5. 评论与审核 (8个工具)

  • get_comments，get_comment
  • create_comment，update_comment，delete_comment
  • approve，spam，trash (审核动作)

6. 菜单与导航 (10个工具)

经典菜单

  • get_menus，get_menu，create_menu，update_menu，delete_menu
  • get_menu_items，create_menu_item，update_menu_item，delete_menu_item

位置

  • get_locations

7. 全站编辑 - FSE (27个工具)

模板及模板部分 (10个工具)

  • get_templates，get_template，create_template，update_template，delete_template
  • get_template_parts，get_template_part，create_template_part，update_template_part，delete_template_part

全局样式 (6个工具)

  • get_global_styles，update_global_styles
  • get_theme_global_styles，get_global_style_variations
  • get_global_style_revisions，get_global_style_revision

区块模式 (3个工具)

  • get_local_patterns，get_pattern_categories，search_pattern_directory

导航区块 (8个工具包含在菜单中)

8. Astra Pro集成 (11个工具)

超级菜单 (4个工具)

  • get_mega_menu，update_mega_menu
  • enable_mega_menu，disable_mega_menu

自定义布局与高级挂钩 (5个工具)

  • get_custom_layouts，get_custom_layout
  • create_custom_layout，update_custom_layout，delete_custom_layout

主题设置 (2个工具)

  • get_settings，update_settings

9. 站点配置 (15个工具)

站点设置 (5个工具)

  • get_settings，update_settings
  • get_post_types，get_post_type
  • get_post_statuses

插件 (5个工具)

  • list，get，activate，deactivate，delete

小工具与侧边栏 (7个工具)

  • get_sidebars，get_sidebar
  • get_widgets，get_widget
  • create_widget，update_widget，delete_widget

主题管理 (2个工具)

  • list_themes，get_custom_css，update_custom_css

10. 站点健康与诊断 (8个工具)

  • test_auth - 授权头测试
  • test_background_updates - 后台更新检查
  • test_dotorg_communication - WordPress.org连接性
  • test_https - HTTPS验证
  • test_loopback - 回环请求测试
  • test_page_cache - 页面缓存验证
  • get_directory_sizes - 存储监控
  • run_all_tests - 综合健康报告

11. 搜索与发现 (5个工具)

  • search - 通用内容搜索
  • oembed - 富嵌入数据检索
  • oembed_proxy - 外部oEmbed代理
  • get_url_details - 块的URL元数据
  • block_directory - WordPress.org区块搜索

12. WooCommerce (3个工具)

  • get_products - 产品目录
  • get_orders - 订单管理
  • get_sales - 销售分析

13. 系统发现 (5个工具)

  • discover_endpoints - 列出所有可用端点
  • 主题、插件和能力发现

🚀 快速开始

预备条件

Node.js ≥ 22.0.0
pnpm (推荐) 或 npm
启用REST API的WordPress站点
应用密码或JWT令牌

安装

通过NPM (推荐)

# 全局安装
npm install -g claudeus-wp-mcp

# 或直接使用npx
npx claudeus-wp-mcp

开发用途

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

# 安装依赖
pnpm install

# 构建
pnpm build

# 使用Inspector UI测试
pnpm inspector

⚙️ 配置

1. 创建wp-sites.json

创建一个wp-sites.json文件来配置您的WordPress站点：

{
  "default_test": {
    "URL": "https://your-site.com",
    "USER": "admin",
    "PASS": "your-application-password",
    "authType": "basic"
  },
  "production": {
    "URL": "https://production-site.com",
    "USER": "admin",
    "PASS": "prod-app-password",
    "authType": "basic"
  }
}

获取您的应用密码

  1. 登录WordPress管理员
  2. 转到用户 → 个人资料
  3. 滚动到应用密码
  4. 输入名称（例如："Claude MCP"）
  5. 点击添加新
  6. 复制生成的密码（格式：xxxx xxxx xxxx xxxx xxxx xxxx）

2. 配置Claude桌面

添加到您的Claude桌面配置：

文件位置：

  • macOS：~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows：%APPDATA%\Claude\claude_desktop_config.json

配置：

{
  "mcpServers": {
    "claudeus-wp-mcp": {
      "command": "npx",
      "args": ["-y", "claudeus-wp-mcp"],
      "env": {
        "WP_SITES_PATH": "/绝对路径到你的wp-sites.json"
      }
    }
  }
}

3. 重启Claude桌面

配置后：

  1. 完全重启Claude桌面
  2. 查找输入框中的🔨锤子图标
  3. 点击它查看所有145个WordPress工具
  4. 开始自动化！🤘

🎸 使用MCP Inspector

Inspector UI允许您可视化地测试和探索所有工具：

# 启动Inspector
pnpm inspector

# 在浏览器中打开http://localhost:5173

Inspector特性：

  • 🔍 探索工具：浏览所有145个工具及其描述
  • ⚡ 测试端点：使用示例数据尝试工具
  • 📊 查看响应：查看真实的API响应
  • 🐛 调试：监控服务器通信
  • 📝 测试提示：尝试AI驱动的工作流

💪 架构亮点

模块化设计

src/
├── api/              # 17个专门的API客户端
│   ├── posts.ts      # 文章API
│   ├── taxonomies.ts # 分类法API
│   ├── users.ts      # 用户API
│   ├── health.ts     # 站点健康API
│   └── ...           # 还有13个！
│
├── tools/            # 按类别实现的工具
│   ├── content/      # 内容管理 (25个工具)
│   ├── taxonomy/     # 分类与标签 (12个工具)
│   ├── user/         # 用户管理 (10个工具)
│   ├── health/       # 站点健康 (8个工具)
│   └── ...           # 还有10个模块！
│
├── types/            # TypeScript定义
│   ├── post.ts       # 文章类型
│   ├── taxonomy.ts   # 分类法类型
│   ├── health.ts     # 健康类型
│   └── ...           # 完整类型覆盖
│
├── handlers/         # 请求处理器
│   ├── tools.ts      # 工具路由
│   ├── resources.ts  # 资源处理器
│   └── prompts.ts    # 提示处理器
│
└── security/         # 安全框架
    ├── validation/   # 输入验证
    ├── sanitization/ # 输出清理
    └── auth/         # 认证

关键特性

特性实现优点
类型安全100% TypeScript，严格模式零运行时类型错误
模块化20多个独立模块易于维护和扩展
安全多层验证企业级保护
性能分页、缓存、批处理处理大数据集
错误处理全面的try-catch平稳失败恢复

🔒 安全特性

认证

  • ✅ 基本认证（应用密码）
  • ✅ 支持JWT令牌
  • ✅ 安全凭证管理

验证

  • ✅ 输入清理
  • ✅ 输出转义
  • ✅ 模式验证
  • ✅ 类型检查

保护

  • ✅ 防止SQL注入
  • ✅ 防止XSS
  • ✅ 防止CSRF
  • ✅ 支持速率限制

📈 性能与可扩展性

分页支持

所有列表端点支持带有元数据的分页：

{
  "data": [...],
  "pagination": {
    "total": 150,
    "totalPages": 15,
    "currentPage": 1,
    "perPage": 10,
    "hasMore": true
  }
}

批量操作

  • 批量内容更新
  • 批量媒体处理
  • 多站点操作

缓存

  • 响应缓存
  • 查询优化
  • 高效的数据获取

🎯 使用案例

内容创作者

  • ✅ AI驱动的博客文章生成
  • ✅ 批量内容更新
  • ✅ SEO优化
  • ✅ 媒体管理

开发者

  • ✅ 无头CMS集成
  • ✅ 自定义主题开发
  • ✅ 插件测试与调试
  • ✅ API自动化

站点管理员

  • ✅ 多站点管理
  • ✅ 用户与访问控制
  • ✅ 站点健康监控
  • ✅ 性能优化

机构

  • ✅ 客户站点管理
  • ✅ 部署自动化
  • ✅ 内容迁移
  • ✅ 维护工作流程

⚠️ 重要注意事项

危险级别

级别描述示例
🟢 安全仅读操作get_posts，list_themes
🟡 中等内容修改create_post，update_media
🔴 高破坏性操作delete_post，delete_user

最佳实践

  1. 🔒 总是备份：在批量操作之前
  2. 🧪 先测试：使用测试环境
  3. 👀 审查更改：验证AI生成的内容
  4. 🔐 保护凭证：保护应用密码
  5. 📊 监控使用情况：跟踪API调用和性能

🧪 测试

运行综合测试套件：

# 所有测试
pnpm test

# 特定套件
pnpm test:unit
pnpm test:integration

# 带覆盖率
pnpm test:coverage

📚 文档