@xiedada/nodemw-mcp-server

v0.2.4

Published

6 days ago

MCP server for nodemw - MediaWiki API client

Downloads

930

0High
0Medium
0Low

xiedada

mcp mediawiki nodemw wiki

Nodemw MCP Server

A Model Context Protocol (MCP) server for nodemw, the Node.js MediaWiki API client.

Quick Start

# Install
npm install
npm run build

# Connect as guest
node dist/index.js zh.minecraft.wiki

# Connect with credentials
node dist/index.js -u myuser -p mypass mywiki.example.com

CLI Usage

nodemw-mcp-server [options] [server]

Arguments:

| Option | Short | Description | |--------|-------|-------------| | [server] | (positional) | Target MediaWiki server, e.g. en.wikipedia.org | | --server | -s | Same as positional, explicit form | | --path | | API script path (default: auto-detect; tries /w then root) | | --endpoint | | Alias for --path | | --user | -u | Login username | | --pass | -p | Login password | | --token | | Bot token (alternative to username/password) | | --user-agent | -A | Custom User-Agent string (replaces default) | | --user-agent-append | | Append custom User-Agent to default instead of replacing | | --debug | | Enable debug logging | | --dry-run | | Dry-run mode (no actual edits) |

Examples:

# Guest access, auto-detect API path
nodemw-mcp-server zh.minecraft.wiki

# Authenticated, explicit API path
nodemw-mcp-server -u editor -p secret --path /w mywiki.example.com

# With full URL
nodemw-mcp-server -s https://en.wikipedia.org

# Dry-run mode for safe testing
nodemw-mcp-server --dry-run -u editor -p secret mywiki.example.com

# Custom User-Agent (replace default)
nodemw-mcp-server -A "MyBot/1.0" mywiki.example.com

# Append to default User-Agent
nodemw-mcp-server --user-agent-append -A "MyBot/1.0" mywiki.example.com

# Debug mode
nodemw-mcp-server --debug mywiki.example.com

Environment Variables

All settings can be configured via environment variables. CLI arguments take precedence.

| Variable | Equivalent | |----------|------------| | NODEMW_MCP_SERVER | --server / positional | | NODEMW_MCP_ENDPOINT_PATH | --path | | NODEMW_MCP_MW_USER | --user / -u | | NODEMW_MCP_MW_PASS | --pass / -p | | NODEMW_MCP_MW_TOKEN | --token | | NODEMW_MCP_USER_AGENT | --user-agent / -A | | NODEMW_MCP_USER_AGENT_APPEND | --user-agent-append (set to 1) | | NODEMW_MCP_DEBUG | --debug (set to 1) |

Usage with config files

{
  "mcpServers": {
    "nodemw": {
      "command": "npx",
      "args": ["@xiedada/nodemw-mcp-server"],
      "env": {
        "NODEMW_MCP_SERVER": "mywiki.example.com",
        "NODEMW_MCP_MW_USER": "editor",
        "NODEMW_MCP_MW_PASS": "secret"
      }
    }
  }
}

Available Tools

Read Operations (33 tools)

get-article, get-article-with-lineno, get-article-by-revision, search, get-pages-in-category, get-categories, get-users, get-all-pages, get-pages-in-namespace, get-pages-by-prefix, get-pages-transcluding, get-article-revisions, get-article-categories, get-article-properties, get-article-info, get-user-contribs, whoami, whois, whoare, get-images, get-images-from-article, get-image-usage, get-image-info, get-log, expand-templates, parse, get-recent-changes, get-site-info, get-site-stats, get-mediawiki-version, get-external-links, get-backlinks, get-query-page

Write Operations (16 tools, require authentication)

edit, write, append, prepend, move, delete, undelete, protect, block, unblock, purge, send-email, upload, upload-by-url, add-flow-topic, create-account

Development

npm run build        # Build dist/index.js
npm run dev          # Watch mode
npm run clean        # Remove dist/
npm test             # Run tests

License

Copyright (c) 2026 Xie Youtian

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this
  list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice,
  this list of conditions and the following disclaimer in the documentation
  and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

Nodemw MCP Server（中文）

一个为 nodemw（Node.js MediaWiki API 客户端）构建的 Model Context Protocol (MCP) 服务器。

快速开始

# 安装
npm install
npm run build

# 以游客身份连接
node dist/index.js zh.minecraft.wiki

# 使用账号密码连接
node dist/index.js -u myuser -p mypass mywiki.example.com

CLI 用法

nodemw-mcp-server [options] [server]

参数说明：

| 参数 | 简写 | 说明 | |--------|-------|-------------| | [server] | (位置参数) | 目标 MediaWiki 服务器，如 en.wikipedia.org | | --server | -s | 同上，显式形式 | | --path | | API 脚本路径（默认：自动检测；先尝试 /w，再尝试根路径） | | --endpoint | | --path 的别名 | | --user | -u | 登录用户名 | | --pass | -p | 登录密码 | | --token | | 机器人令牌（替代用户名/密码） | | --user-agent | -A | 自定义 User-Agent 字符串（替换默认值） | | --user-agent-append | | 将自定义 User-Agent 追加到默认值之后 | | --debug | | 启用调试日志 | | --dry-run | | 干运行模式（不执行实际编辑） |

示例：

# 游客访问，自动检测 API 路径
nodemw-mcp-server zh.minecraft.wiki

# 认证访问，手动指定 API 路径
nodemw-mcp-server -u editor -p secret --path /w mywiki.example.com

# 使用完整 URL
nodemw-mcp-server -s https://en.wikipedia.org

# 干运行模式，安全测试
nodemw-mcp-server --dry-run -u editor -p secret mywiki.example.com

# 自定义 User-Agent（替换默认值）
nodemw-mcp-server -A "MyBot/1.0" mywiki.example.com

# 追加到默认 User-Agent
nodemw-mcp-server --user-agent-append -A "MyBot/1.0" mywiki.example.com

# 调试模式
nodemw-mcp-server --debug mywiki.example.com

环境变量

所有设置都可以通过环境变量配置，CLI 参数优先级更高。

| 变量 | 等效参数 | |----------|------------| | NODEMW_MCP_SERVER | --server / 位置参数 | | NODEMW_MCP_ENDPOINT_PATH | --path | | NODEMW_MCP_MW_USER | --user / -u | | NODEMW_MCP_MW_PASS | --pass / -p | | NODEMW_MCP_MW_TOKEN | --token | | NODEMW_MCP_USER_AGENT | --user-agent / -A | | NODEMW_MCP_USER_AGENT_APPEND | --user-agent-append（设为 1） | | NODEMW_MCP_DEBUG | --debug（设为 1） |

配合配置文件使用

{
  "mcpServers": {
    "nodemw": {
      "command": "npx",
      "args": ["@xiedada/nodemw-mcp-server"],
      "env": {
        "NODEMW_MCP_SERVER": "mywiki.example.com",
        "NODEMW_MCP_MW_USER": "editor",
        "NODEMW_MCP_MW_PASS": "secret"
      }
    }
  }
}

可用工具

读取操作（33 个工具）

get-article、get-article-with-lineno、get-article-by-revision、search、get-pages-in-category、get-categories、get-users、get-all-pages、get-pages-in-namespace、get-pages-by-prefix、get-pages-transcluding、get-article-revisions、get-article-categories、get-article-properties、get-article-info、get-user-contribs、whoami、whois、whoare、get-images、get-images-from-article、get-image-usage、get-image-info、get-log、expand-templates、parse、get-recent-changes、get-site-info、get-site-stats、get-mediawiki-version、get-external-links、get-backlinks、get-query-page

写入操作（16 个工具，需要认证）

edit、write、append、prepend、move、delete、undelete、protect、block、unblock、purge、send-email、upload、upload-by-url、add-flow-topic、create-account

开发

npm run build        # 构建 dist/index.js
npm run dev          # 监视模式
npm run clean        # 删除 dist/
npm test             # 运行测试

许可协议

Copyright (c) 2026 Xie Youtian

Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are met:

1. Redistributions of source code must retain the above copyright notice, this
  list of conditions and the following disclaimer.

2. Redistributions in binary form must reproduce the above copyright notice,
  this list of conditions and the following disclaimer in the documentation
  and/or other materials provided with the distribution.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE
DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT HOLDER OR CONTRIBUTORS BE LIABLE
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR
SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER
CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY,
OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.