Wolai MCP

SlavaTANG/wolai-mcp

0 Stars 71 次浏览更新于 2026-08-23

通过模型上下文协议（MCP）将AI代理连接到您的Wolai知识库的服务器。它允许您使用各种兼容MCP的AI代理来读取、写入、搜索和浏览您的Wolai页面。

知识管理与记忆

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "wolai-kb": {
      "args": [
        "wolai-mcp"
      ],
      "command": "uvx",
      "env": {
        "WOLAI_APP_ID": "your_app_id",
        "WOLAI_APP_SECRET": "your_app_secret",
        "WOLAI_ROOT_ID": "your_root_page_id"
      }
    }
  }
}

该服务需要配置环境变量：WOLAI_APP_ID、WOLAI_APP_SECRET、WOLAI_ROOT_ID

服务介绍

Wolai MCP Server 🐺

English | 中文

通过 MCP 协议将 AI 智能体连接到你的 Wolai 知识库。

从 Claude、Gemini、Cursor 或任何 MCP 兼容的 AI 智能体中读取、写入、搜索和管理你的 Wolai 页面。

✨ 功能一览

类别	工具	说明
📖 读取	`get_page_content`, `list_child_blocks`, `get_root_info`, `get_breadcrumbs`	读取页面、列出子页面、导航层级结构
🔍 搜索	`search_pages_by_title`	按标题模糊搜索页面树
✏️ 写入	`create_page`, `add_block`, `add_code_block`	创建页面、添加文本/列表/标题/代码块
⚙️ 配置	`set_wolai_credentials`, `set_root_page`, `get_wolai_config`	运行时凭证和根页面管理

共 11 个工具 — 覆盖读取、写入、搜索和配置功能。

🚀 快速开始

方式一：`uvx` 直接运行（推荐）

无需安装，在临时隔离环境中直接运行：

uvx wolai-mcp

没有 uv？一键安装：curl -LsSf https://astral.sh/uv/install.sh | sh

方式二：`pip` 安装

pip install wolai-mcp

获取凭证

前往 Wolai 开发者平台
创建应用 → 获取 App ID 和 App Secret
从 Wolai 页面 URL 中获取根页面 ID

📋 配置

所有凭证通过环境变量传入 — 无需修改任何代码。

变量	说明	必填
`WOLAI_APP_ID`	Wolai 应用 ID	✅
`WOLAI_APP_SECRET`	Wolai 应用密钥	✅
`WOLAI_ROOT_ID`	知识库根页面 ID	可选（用于搜索/导航）

🔧 各平台配置方式

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "wolai-kb": {
      "command": "uvx",
      "args": ["wolai-mcp"],
      "env": {
        "WOLAI_APP_ID": "你的应用ID",
        "WOLAI_APP_SECRET": "你的密钥",
        "WOLAI_ROOT_ID": "你的根页面ID"
      }
    }
  }
}

{
  "mcpServers": {
    "wolai-kb": {
      "command": "wolai-mcp",
      "env": {
        "WOLAI_APP_ID": "你的应用ID",
        "WOLAI_APP_SECRET": "你的密钥",
        "WOLAI_ROOT_ID": "你的根页面ID"
      }
    }
  }
}

Gemini CLI

添加到 ~/.gemini/settings.json：

{
  "mcpServers": {
    "wolai-kb": {
      "command": "wolai-mcp",
      "env": {
        "WOLAI_APP_ID": "你的应用ID",
        "WOLAI_APP_SECRET": "你的密钥",
        "WOLAI_ROOT_ID": "你的根页面ID"
      }
    }
  }
}

Cursor / CherryStudio / 其他 MCP 客户端

{
  "wolai-kb": {
    "command": "uvx",
    "args": ["wolai-mcp"],
    "env": {
      "WOLAI_APP_ID": "你的应用ID",
      "WOLAI_APP_SECRET": "你的密钥",
      "WOLAI_ROOT_ID": "你的根页面ID"
    }
  }
}

{
  "wolai-kb": {
    "command": "wolai-mcp",
    "env": {
      "WOLAI_APP_ID": "你的应用ID",
      "WOLAI_APP_SECRET": "你的密钥",
      "WOLAI_ROOT_ID": "你的根页面ID"
    }
  }
}

💡 使用示例

配置完成后，可以直接对 AI 智能体说：

"读取我 Wolai 知识库的首页内容"
"搜索标题包含'项目计划'的页面"
"在首页下创建一个新页面叫'会议纪要'"
"往指定页面添加一段代码"
"显示当前 Wolai 配置状态"

🔐 运行时配置

无需重启即可更换配置：

set_wolai_credentials — 切换 Wolai 账号
set_root_page — 更换知识库根页面
get_wolai_config — 查看当前配置

💖 支持本项目

如果 Wolai MCP 对你有帮助，欢迎请作者喝杯咖啡！
你的支持是项目持续维护和迭代的最大动力 ✨

☕ 爱发电

支持支付宝 / 微信支付

💎 加密货币 (USDC / ERC-20)

点击捐赠 — 支持 MetaMask、SafePal 等钱包

每一份支持都是莫大的鼓励 — 感谢！ 🙏

📄 许可证

MIT 许可证 — 详见 LICENSE。

查看源码项目主页