Wolai MCP Server 🐺

English | 中文

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

Option A: Quick Run with uvx (Recommended)

No installation needed — runs in a temporary isolated environment:

uvx wolai-mcp

Don't have uv? Install it: curl -LsSf https://astral.sh/uv/install.sh | sh

Option B: Install with pip

pip install wolai-mcp

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.

🔧 Platform Configuration

Claude Desktop

Add to claude_desktop_config.json:

{
  "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

Add to ~/.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 / Other MCP Clients

{
  "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"
    }
  }
}

💡 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

💖 Support This Project

If you find Wolai MCP useful, consider buying me a coffee! Your support keeps this project alive and growing ✨

☕ 爱发电 (Afdian) Supports Alipay & WeChat Pay

💎 Crypto (USDC / ERC-20) Click to donate — supports MetaMask, SafePal & more

Every little bit helps — thank you! 🙏

📄 License

MIT License — see LICENSE for details.