bwiki-mcp

bwiki-mcp

专为BWIKI编辑优化的MCP服务器，提供语义化工具用于页面编辑、分类管理、内容获取等操作。

Category
Visit Server

README

BWIKI MCP Server

License: MIT Node.js MCP

专为 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

🙏 致谢

Recommended Servers

playwright-mcp

playwright-mcp

A Model Context Protocol server that enables LLMs to interact with web pages through structured accessibility snapshots without requiring vision models or screenshots.

Official
Featured
TypeScript
Magic Component Platform (MCP)

Magic Component Platform (MCP)

An AI-powered tool that generates modern UI components from natural language descriptions, integrating with popular IDEs to streamline UI development workflow.

Official
Featured
Local
TypeScript
Audiense Insights MCP Server

Audiense Insights MCP Server

Enables interaction with Audiense Insights accounts via the Model Context Protocol, facilitating the extraction and analysis of marketing insights and audience data including demographics, behavior, and influencer engagement.

Official
Featured
Local
TypeScript
VeyraX MCP

VeyraX MCP

Single MCP tool to connect all your favorite tools: Gmail, Calendar and 40 more.

Official
Featured
Local
graphlit-mcp-server

graphlit-mcp-server

The Model Context Protocol (MCP) Server enables integration between MCP clients and the Graphlit service. Ingest anything from Slack to Gmail to podcast feeds, in addition to web crawling, into a Graphlit project - and then retrieve relevant contents from the MCP client.

Official
Featured
TypeScript
Kagi MCP Server

Kagi MCP Server

An MCP server that integrates Kagi search capabilities with Claude AI, enabling Claude to perform real-time web searches when answering questions that require up-to-date information.

Official
Featured
Python
E2B

E2B

Using MCP to run code via e2b.

Official
Featured
Neon Database

Neon Database

MCP server for interacting with Neon Management API and databases

Official
Featured
Exa Search

Exa Search

A Model Context Protocol (MCP) server lets AI assistants like Claude use the Exa AI Search API for web searches. This setup allows AI models to get real-time web information in a safe and controlled way.

Official
Featured
Qdrant Server

Qdrant Server

This repository is an example of how to create a MCP server for Qdrant, a vector search engine.

Official
Featured