wolai-mcp 1.1.0

MCP Server for Wolai — Connect AI agents to your Wolai knowledge base

Wolai MCP Server 🐺

Connect AI agents to your Wolai knowledge base via the Model Context Protocol (MCP).

Read, write, search, and navigate your Wolai pages — all from Claude, Gemini, Cursor, or any MCP-compatible AI agent.

---

✨ Features

Category	Tools	Description
📖 Read	get_page_content, list_child_blocks, get_root_info, get_breadcrumbs	Read pages, list children, navigate hierarchy
🔍 Search	search_pages_by_title	Fuzzy title search across page tree
✏️ Write	create_page, add_block, add_code_block	Create pages, append text/lists/headings/code
⚙️ Config	set_wolai_credentials, set_root_page, get_wolai_config	Runtime credential & root page management

11 tools total — covering read, write, search, and configuration.

---

🚀 Quick Start

Install

pip install wolai-mcp

Or install from source:

git clone https://github.com/LittlePeter52012/wolai-mcp.git
cd wolai-mcp
pip install -e .

Get Credentials

1. Go to Wolai Developer Console
2. Create an application → get App ID and App Secret
3. Find the Root Page ID from your Wolai page URL

---

📋 Configuration

All credentials are passed via environment variables — no need to edit any code.

Environment Variables

Variable	Description	Required
WOLAI_APP_ID	Wolai Application ID	✅
WOLAI_APP_SECRET	Wolai Application Secret	✅
WOLAI_ROOT_ID	Root page ID for your knowledge base	Optional (for search/navigation)

---

🔧 Platform Configuration

Claude Desktop

Add to claude_desktop_config.json:

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

Claude Code

claude mcp add-json wolai-kb '{
  "type": "stdio",
  "command": "wolai-mcp",
  "env": {
    "WOLAI_APP_ID": "your_app_id",
    "WOLAI_APP_SECRET": "your_app_secret",
    "WOLAI_ROOT_ID": "your_root_page_id"
  }
}' --scope user

Gemini CLI

Add to ~/.gemini/settings.json:

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

Cursor

Add to Cursor Settings → MCP:

{
  "wolai-kb": {
    "command": "wolai-mcp",
    "env": {
      "WOLAI_APP_ID": "your_app_id",
      "WOLAI_APP_SECRET": "your_app_secret",
      "WOLAI_ROOT_ID": "your_root_page_id"
    }
  }
}

---

💡 Usage Examples

Once configured, ask your AI agent:

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

---

🔐 Runtime Configuration

You can also change credentials at runtime without restarting:

• set_wolai_credentials — Switch Wolai account
• set_root_page — Change the root knowledge base page
• get_wolai_config — Check current configuration

---

📄 License

MIT License — see LICENSE for details.