使用说明
沃莱MCP服务器🐺
英语 | 中文
将AI代理连接到您的 沃莱 知识库 通过模型上下文协议(MCP)。
读取、写入、搜索和导航您的Wolai页面——所有这些都来自Claude、Gemini、Cursor或任何兼容MCP的AI代理。
✨ 特性
| 类别 | 工具 | 描述 |
|---|---|---|
| 📖 阅读 | 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个工具 --涵盖读取、写入、搜索和配置。
🚀 快速开始
安装
选项A:快速运行 uvx (推荐)
无需安装--在临时隔离环境中运行:
uvx wolai-mcp
没有
uv?安装它:curl -LsSf https://astral.sh/uv/install.sh | sh
选项B:安装 pip
pip install wolai-mcp
获取凭据
- 首选 Wolai开发者控制台
- 创建应用程序→ get 应用程序ID 和 应用密钥
- 查找 根页面ID 从您的Wolai页面URL
📋 配置
所有凭据都通过传递 环境变量 --无需编辑任何代码。
| 变量 | 描述 | 必填 |
|---|---|---|
WOLAI_APP_ID |
沃莱应用程序ID | ✅ |
WOLAI_APP_SECRET |
沃莱应用秘密 | ✅ |
WOLAI_ROOT_ID |
知识库的根页面ID | 可选(用于搜索/导航) |
🔧 平台配置
克劳德桌面版
增添 claude_desktop_config.json:
| uvx (recommended) | pip |
|---|---|
|
|
Gemini CLI
增添 ~/.gemini/settings.json:
{
"mcpServers": {
"wolai-kb": {
"command": "wolai-mcp",
"env": {
"WOLAI_APP_ID": "your_app_id",
"WOLAI_APP_SECRET": "your_secret",
"WOLAI_ROOT_ID": "your_root_id"
}
}
}
}
Cursor/CherryStudio/其他MCP客户端
| uvx | pip |
|---|---|
|
|
💡 使用示例
配置后,询问您的AI代理:
- "读取我 Wolai 知识库的首页内容"
- "搜索标题包含'项目计划'的页面"
- "在首页下创建一个新页面叫'会议纪要'"
- "往指定页面添加一段代码"
- "显示当前 Wolai 配置状态"
🔐 运行时配置
您还可以在运行时更改凭据,而无需重新启动:
set_wolai_credentials--切换沃莱账户set_root_page--更改根知识库页面get_wolai_config--检查当前配置
💖 支持这个项目
如果你发现 沃莱MCP 有用的,考虑给我买杯咖啡! 您的支持使这个项目保持活力并不断发展✨
☕ 爱发电 (Afdian)支持支付宝和微信支付 |
💎 加密货币(USDC/ERC-20)点击捐赠--支持MetaMask、SafePal等 |
每一点点都有帮助-- 非常感谢。 🙏
📄 许可证
MIT许可证——见 许可证 了解详情。