Rapls Ai Chatbot (wordpress Mcp Server)

Rapls AI Chatbot

这是一款可在 WordPress 网站中部署 AI 聊天机器人的插件。它使用 RAG（检索增强生成）结合自站文章内容回答问题，并且内置 MCP（Model Context Protocol）服务，因此可以通过 Claude Desktop 或 Cursor 直接访问网站数据。

支持 OpenAI / Claude / Gemini / OpenRouter。对话数据保存在您自己的服务器上，不会发送到外部 SaaS（自带密钥 / 可自托管）。

功能

• 支持多个提供商 — OpenAI / Claude / Gemini / OpenRouter（100+ 种模型）
• 基于 RAG 的回答 — 使用网站文章构建知识的混合搜索（向量嵌入 + 关键词）
• 知识库 — 支持问答、自由文本和 PDF/DOCX 上传
• 网页搜索 — 自动使用各提供商内置的搜索功能
• 内置 MCP 服务 — 提供 5 个工具（详情见下文）
• 支持 WordPress 7.0 Connectors API — 在整个网站中统一管理 AI 提供商
• 支持 Gutenberg 区块 — 可通过可视化编辑器放置
• 无代码设置 — 可在管理界面中完成所有操作
• 支持多语言 — 已做好 i18n 准备，日语翻译完成度 100%

MCP 服务

此插件内置 MCP（Model Context Protocol）服务，可通过 Claude Desktop、Cursor、VS Code 等 MCP 客户端读取和操作 WordPress 网站数据。提供以下 5 个工具。

工具	说明
search_knowledge	搜索知识库和网站内容索引，并返回匹配的文章、常见问题和页面
list_conversations	获取聊天对话列表，包含消息数量（按创建日期排序）
get_conversation	获取指定对话及其完整消息历史
send_message	向 AI 聊天机器人发送消息并获取回复（包含知识库上下文）
get_site_info	获取 WordPress 网站信息和插件配置（不会公开 API 密钥）

其特点是可以通过 MCP 将 WordPress 网站内容直接引入 AI 客户端的上下文中。您不仅可以通过聊天小组件使用「能够回答有关自己网站问题的 AI」，也可以通过本地的 MCP 客户端使用。

如需完整的设置说明（启用服务、生成 API 密钥、客户端配置、curl 测试和故障排除），请参阅 MCP 服务手册。

安装

从 WordPress.org 安装（推荐）

1. WordPress 管理界面 → 插件 → 安装插件
2. 搜索「Rapls AI Chatbot」→ 安装
3. 启用后，通过管理界面的 Rapls AI Chatbot 菜单进行设置

从 GitHub 安装

1. 从 Releases 下载最新版本的 ZIP 文件
2. WordPress 管理界面 → 插件 → 安装插件 → 上传插件
3. 启用

设置

前提条件

• WordPress 6.3 或更高版本（建议在 WordPress 7.0+ 中集成 Connectors API）
• PHP 7.4 或更高版本
• API 密钥 — OpenAI / Anthropic Claude / Google Gemini / OpenRouter 任一

如果不想使用信用卡，可以从 OpenRouter 或 Google Gemini 的免费额度（两者均无需注册银行卡）开始。在设置页面的「先免费运行」面板中选择其中一项，粘贴密钥并点击连接测试，即可自动设置可立即使用的模型。面板会在选择前显示各选项对数据的处理方式（例如，Gemini 免费额度可能会将发送的内容用于改进 Google 的模型），因此您可以了解详情后再做选择。

常见问题 / 故障排除

Q：聊天记录未保存或突然消失

A： 如果使用 WP AI Client，消息编组处理可能会导致聊天记录在没有任何提示的情况下丢失。

详细诊断方法：迁移到 WP AI Client 后，对话记录消失且没有报错

Q：前端未显示聊天框

A： 插入 Gutenberg 区块后，请按照固定链接结构重新保存页面。这样会更新 REST API 缓存。

Q：想要切换使用多个 AI 提供商

A： 如果使用 WordPress 7.0 或更高版本，可以通过 Connectors API 注册多个提供商，并在此插件中选择。

详情：从实现角度解读 WordPress 7.0 的 WP AI Client

Q：想将 PDF、DOCX 添加到知识库

A： 免费版支持此功能。可以通过知识库的上传功能添加文件。

---

WordPress 7.0 中的变更

**自 WordPress 7.0 Armstrong（2026 年 5 月发布）**起，此插件已支持 WP AI Client 和 Connectors API。

• 统一管理 API 密钥 — 在 Connectors UI 中集中管理多个 AI 提供商
• 轻松切换提供商 — 无需在此插件中设置，直接应用整个网站的设置
• 向后兼容 — 在 WordPress 6.3〜6.5 中仍可使用原有的 API 密钥设置方式

详情：WordPress 7.0 支持详情

---

文档

• WordPress.org 插件页面
• 插件介绍页面
• 支持论坛

视频演示

我们制作了视频，演示如何在 5 分钟内免费安装聊天机器人。

英文演示：

如需了解如何根据网站内容回答问题，以及这与原版 ChatGPT 的区别，请观看此视频。

介绍与评测文章（日语）

我们会在文章中介绍安装流程，以及实现过程中遇到的设计抉择。

• 免费在 WordPress 上安装聊天机器人（无需信用卡，支持 OpenRouter 免费模型） — Qiita
• 实际使用数日后的评测：免费版不是试用版的 WordPress AI 聊天机器人
• 「我以为自己已经允许了」在自己的网站上放置 AI 聊天机器人的经历 — note

英文文章

同一段设计故事发布在几个平台上，选择你习惯的平台阅读：

• DEV.to
• Medium
• Hashnode

Pro 版

付费的 Pro 版提供 80 多项功能，包括分析、潜在客户采集与 Webhook 集成、对话场景、WooCommerce 集成、LINE Messaging API 集成、语音输入与输出（STT / TTS）、白标、Slack 通知与 Google Sheets 导出、数据加密（AES-256-GCM、PII 遮蔽）以及多站点支持等。

详情：插件介绍页面

---

开发

要求

• WordPress 6.3 或更高版本
• PHP 7.4 或更高版本
• OpenAI / Anthropic / Google Gemini / OpenRouter 中任一 API 密钥

贡献

请通过 Issues 提交错误报告或功能请求。也欢迎提交 Pull Request。

更新日志

详情请参阅 readme.txt。

作者

Rapls（Rapls） 自由职业 Web 开发者 / WordPress Polyglots PTE（日语翻译负责人）

• Rapls Works
• WordPress.org 个人资料
• GitHub

许可证

GPL v2 或更高版本