BWIKI MCP Server

专为 BWIKI 编辑优化的 MCP (Model Context Protocol) 服务器。基于 Playwright 构建，自动处理 CodeMirror 编辑器，提供语义化的 BWIKI 操作工具。

✨ 特性

• 🎯 BWIKI 专用工具 - 13 个语义化工具，专为 BWIKI 操作设计
• 🔧 自动处理 CodeMirror - 无需手动处理编辑器类型判断
• 📁 智能分类管理 - 自动插入到正确位置，避免重复
• 🔐 持久化登录 - 支持浏览器数据目录保存登录状态
• 🌐 跨平台 - 支持 Windows、macOS、Linux

📦 安装

# 克隆仓库
git clone https://github.com/你的用户名/bwiki-mcp.git
cd bwiki-mcp

# 安装依赖
npm install

# 构建
npm run build

⚙️ 配置

环境变量

Trae IDE / Claude Desktop 配置

在 MCP 配置文件中添加：

{
  "mcpServers": {
    "bwiki-mcp": {
      "command": "node",
      "args": ["/path/to/bwiki-mcp/dist/cli.js"],
      "env": {
        "BWIKI_USER_DATA_DIR": "/path/to/bwiki-mcp/browser-data",
        "BWIKI_BASE_URL": "https://wiki.biligame.com/你的wiki名称"
      }
    }
  }
}

🛠️ 可用工具

📖 使用示例

编辑页面

// 使用 bwiki_edit_page 工具
{
  "pageName": "Main Page",
  "content": "== 新章节 ==\n这是新内容",
  "summary": "添加新章节"
}

添加分类

// 使用 bwiki_add_category 工具
{
  "pageName": "文件:Example.png",
  "category": "游戏UI组件",
  "summary": "添加分类标记"
}

获取页面内容

// 使用 bwiki_get_content 工具
{
  "pageName": "User:用户名/Sandbox"
}

🏗️ 项目结构

bwiki-mcp/
├── src/
│   ├── index.ts           # MCP 服务器主入口
│   ├── cli.ts             # 命令行入口
│   └── tools/
│       └── bwiki-tools.ts  # BWIKI 专用工具实现
├── dist/                   # 编译输出
├── package.json
├── tsconfig.json
└── README.md

🔧 开发

# 开发模式（自动编译）
npm run dev

# 构建
npm run build

⚠️ 安全提示

`browser-data/` 目录包含浏览器登录状态和 Cookies，不要分享给他人！

首次使用时：

1. 创建 browser-data 目录
2. 运行工具时会打开浏览器窗口
3. 手动登录 BWIKI
4. 登录状态会自动保存

📄 许可证

MIT

🙏 致谢

• Microsoft Playwright MCP - 浏览器自动化基础
• Model Context Protocol - MCP 协议规范