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

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

🔧 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.