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

⚙️ 配置

环境变量

变量名	描述	默认值
BWIKI_USER_DATA_DIR	浏览器用户数据目录（持久化登录）	无
BWIKI_HEADLESS	无头模式	false
BWIKI_BASE_URL	BWIKI 基础 URL	https://wiki.biligame.com/gc

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_navigate	导航到 BWIKI 页面
bwiki_edit_page	编辑页面内容（自动处理 CodeMirror）
bwiki_add_category	为页面添加分类标记
bwiki_get_content	获取页面 Wiki 源码
bwiki_get_categories	获取页面分类列表
bwiki_get_file_info	获取文件信息
bwiki_click	点击页面元素
bwiki_evaluate	执行 JavaScript 代码
bwiki_screenshot	截取页面截图
bwiki_snapshot	获取页面 HTML 快照
bwiki_get_url	获取当前 URL
bwiki_wait_for_selector	等待元素出现
bwiki_type	在输入框中输入文本

📖 使用示例

编辑页面

// 使用 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 协议规范