Wolai知识库连接服务

通过模型上下文协议(MCP)连接AI代理与Wolai知识库,实现页面读写、搜索和导航功能。

  • by LittlePeter52012
  • Python
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 LittlePeter52012/wolai-mcp

使用说明

沃莱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

获取凭据

  1. 首选 Wolai开发者控制台
  2. 创建应用程序→ get 应用程序ID 和 应用密钥
  3. 查找 根页面ID 从您的Wolai页面URL

📋 配置

所有凭据都通过传递 环境变量 --无需编辑任何代码。

变量 描述 必填
WOLAI_APP_ID 沃莱应用程序ID ✅
WOLAI_APP_SECRET 沃莱应用秘密 ✅
WOLAI_ROOT_ID 知识库的根页面ID 可选(用于搜索/导航)

🔧 平台配置

克劳德桌面版

增添 claude_desktop_config.json:

uvx (recommended)pip
{
  "mcpServers": {
    "wolai-kb": {
      "command": "uvx",
      "args": ["wolai-mcp"],
      "env": {
        "WOLAI_APP_ID": "your_app_id",
        "WOLAI_APP_SECRET": "your_secret",
        "WOLAI_ROOT_ID": "your_root_id"
      }
    }
  }
}
{
  "mcpServers": {
    "wolai-kb": {
      "command": "wolai-mcp",
      "env": {
        "WOLAI_APP_ID": "your_app_id",
        "WOLAI_APP_SECRET": "your_secret",
        "WOLAI_ROOT_ID": "your_root_id"
      }
    }
  }
}

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客户端

uvxpip
{
  "wolai-kb": {
    "command": "uvx",
    "args": ["wolai-mcp"],
    "env": {
      "WOLAI_APP_ID": "your_app_id",
      "WOLAI_APP_SECRET": "your_secret",
      "WOLAI_ROOT_ID": "your_root_id"
    }
  }
}
{
  "wolai-kb": {
    "command": "wolai-mcp",
    "env": {
      "WOLAI_APP_ID": "your_app_id",
      "WOLAI_APP_SECRET": "your_secret",
      "WOLAI_ROOT_ID": "your_root_id"
    }
  }
}

💡 使用示例

配置后,询问您的AI代理:

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

🔐 运行时配置

您还可以在运行时更改凭据,而无需重新启动:

  • set_wolai_credentials --切换沃莱账户
  • set_root_page --更改根知识库页面
  • get_wolai_config --检查当前配置

💖 支持这个项目

如果你发现 沃莱MCP 有用的,考虑给我买杯咖啡! 您的支持使这个项目保持活力并不断发展✨

☕ 爱发电 (Afdian)

支持支付宝和微信支付

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

点击捐赠--支持MetaMask、SafePal等

每一点点都有帮助-- 非常感谢。 🙏


📄 许可证

MIT许可证——见 许可证 了解详情。