MainWP

Name: MainWP
Author: mainwp

本地服务

docs.mainwp.com云与基础设施312 周前更新

代码仓库访问官网

关于 MainWP

MainWP MCP Server 将兼容 MCP 的 AI 工具连接到 MainWP 自托管仪表板，面向管理多个 WordPress 站点的代理机构和自由职业者。它提供跨站点维护工具，并默认要求批准破坏性更改。

主要功能

01管理子站点及连接状态
02查看并应用核心、插件和主题更新
03管理插件、主题、客户和标签
04读取站点备注与工作记忆
05生成网络摘要、安全审计和更新计划
06批准流程、安全模式与工具访问控制

适用场景

01检查多个站点待处理的插件更新
02为多个站点执行更新并先审阅更改
03查看客户站点的连接状态和记录
04生成网络安全审计或站点报告

MCP 相关

它向 MCP 客户端提供 MainWP 仪表板管理工具，将站点、更新、插件、主题和客户操作开放给 AI 工具。服务运行在本地计算机上，并通过 WordPress Application Password 连接仪表板。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "mainwp-mainwp": {
      "command": "npx",
      "args": [
        "-y",
        "@mainwp/mcp"
      ],
      "env": {
        "MAINWP_URL": "<MAINWP_URL>",
        "MAINWP_USER": "<MAINWP_USER>",
        "MAINWP_APP_PASSWORD": "<MAINWP_APP_PASSWORD>"
      }
    }
  }
}

启动命令npx -y @mainwp/mcp

需要配置的环境变量

MAINWP_URLAddress of your MainWP Dashboard, such as https://dashboard.example.com

MAINWP_USERWordPress username of the Dashboard administrator (the login name, not the display name)

MAINWP_APP_PASSWORD密钥WordPress Application Password for that user, not their login password

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@mainwp/mcp1.5.1stdio

工具

收录的工具列表 · 更新于 2 周前

此工具无需参数。

详细介绍

只需与 AI 助手对话，即可管理整个 WordPress 网络。

网站 · 文档 · 快速入门 · 提示词示例集 · 视频 · 社区 · Discord · 支持

官方 MainWP MCP 服务

MainWP MCP 服务可将 Claude、Cursor、OpenAI Codex、VS Code Copilot 和其他兼容 MCP 的 AI 工具连接到 MainWP。MainWP 是一款可自托管的控制面板，用于管理多个 WordPress 站点。你可以用日常语言提出请求：

“哪些站点有待处理的插件更新？”

“在所有 WooCommerce 版本落后的站点上进行更新。”

“目前哪些客户站点已断开连接？”

“更新任何内容前，先查看我们掌握的有关这位客户站点的信息。”

它运行在你自己的电脑上，与 AI 工具并行。无需在控制面板或子站点上安装任何新内容。

通过 MainWP MCP 服务进行的终端对话：询问我管理着多少个站点，然后更新所有 WooCommerce 版本落后的站点

始终由你掌控

更改需经你批准。 默认情况下，删除站点、插件或主题时会先显示预览，并且只有在你确认后才会执行。在 Dashboard 6.3 及更高版本中，更新也采用相同方式。
安全模式会直接阻止这些破坏性操作，不会显示批准提示，让你可以安心熟悉操作。
工具由你选择。 通过允许和屏蔽列表，决定 AI 能看到哪些工具。
凭据由你保管。 服务使用 WordPress 应用程序密码登录，你可以随时撤销该密码；它只会与控制面板通信。

了解其工作原理：安全与权限。

你可以做什么

站点： 列出、同步、检查连接状态、添加、重新连接或移除子站点
更新： 查看整个网络中待处理的核心、插件、主题和翻译更新，并应用更新
插件和主题： 查看已安装的内容、启用、停用或删除
客户和标签： 管理客户记录、分配站点并跟踪成本
知识： AI 工作前会读取的代理机构、客户和站点备注、技能与记忆（Dashboard 6.3 及更高版本）
引导式工作流： 网络摘要、站点报告、安全审计和更新计划

根据你的 Dashboard 版本，工具总数约为 70 个。请参阅工具与资源。

专为管理多个 WordPress 站点、希望借助 AI 处理更新、维护和客户事务的代理机构及自由职业者打造。

要求

运行 AI 工具的电脑上需安装 Node.js 20.19 或更高版本
MainWP Dashboard 6.0 或更高版本，可通过 HTTPS 访问（部分工具需要更新版本的 Dashboard；快速入门中列出了具体要求）
兼容 MCP 的 AI 客户端

开始使用

1. 创建应用程序密码。 在 MainWP Dashboard 中，前往 Users > Profile > Application Passwords，添加一个名为 "MainWP MCP Server" 的密码，并将其复制。它与登录密码相互独立，你可以随时撤销。专门创建一个用于 API 访问的管理员账户，有助于保持审计记录清晰。

2. 将服务添加到 AI 工具中。 对于 Claude Desktop 和大多数其他 MCP 客户端：

{
  "mcpServers": {
    "mainwp": {
      "command": "npx",
      "args": ["-y", "@mainwp/mcp"],
      "env": {
        "MAINWP_URL": "https://your-dashboard.com",
        "MAINWP_USER": "admin",
        "MAINWP_APP_PASSWORD": "xxxx xxxx xxxx xxxx xxxx xxxx"
      }
    }
  }
}

3. 重启 AI 工具并询问“列出我的所有站点”。配置成功后，系统会按名称和 URL 返回你的子站点。

各客户端的配置文件位置见客户端配置指南。所有设置均见配置参考。

**使用 Claude Code？**该插件会安装服务、Agent 技能以及十个 /mainwp:* 工作流命令：

/plugin marketplace add mainwp/mainwp-mcp
/plugin install mainwp@mainwp-mcp

凭据仍需通过环境变量提供。请参阅 Claude Code 插件。

文档

完整文档位于 docs.mainwp.com/mcp-server：

如果这是你的第一个 MCP 服务，请查看带有截图的快速入门
客户端配置，适用于 Claude Desktop、Claude Code、Cursor、VS Code Copilot、OpenAI Codex 等
安全与权限和限制可用工具
提示词指南：按任务分类的即用型提示词
配置参考，包括未配置凭据时如何通过聊天进行设置
工具与资源、安全模型和故障排除

社区

贡献

欢迎提交 Bug 报告和拉取请求。请按照 SECURITY.md 中的说明，私下报告安全问题。

npm ci             # install dependencies
npm run dev        # run in watch mode
npm run inspect    # test with MCP Inspector
npm test           # run tests
npm run lint       # check code style
npm run format     # fix formatting

每个拉取请求都会触发 CI，运行 lint、格式检查、类型检查、测试和构建。更改配置选项时，请在同一变更中更新文档站点配置参考。.agents/skills/mainwp-dashboard 是 Agent 技能的权威副本；请参阅 docs/plugin.md。