Nodemw MCP Server

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

快速开始

# 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 用法

nodemw-mcp-server [options] [server]

参数说明：

示例：

# 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

环境变量

所有设置都可以通过环境变量进行配置。命令行参数优先级更高。

使用配置文件

{

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

      }

    }

  }

}

可用工具

读取操作（29个工具）

get-article, 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

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

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

开发

npm run build        # Build dist/index.js

npm run dev          # Watch mode

npm run clean        # Remove dist/

npm test             # Run tests

许可证

Copyright (c) 2026 Xie Youtian

以源代码和二进制形式重新分发和使用，无论是否修改，都必须满足以下条件：

1. 源代码的重新分发必须保留上述版权声明、此条件列表以及以下免责声明。

2. 二进制形式的重新分发必须在文档和/或其他随分发提供的材料中复制上述版权声明、此条件列表以及以下免责声明。

本软件按“原样”提供，版权持有者和贡献者不作任何明示或暗示的保证，包括但不限于适销性和特定用途适用性的保证。在任何情况下，版权持有者或贡献者均不对因使用本软件而引起的直接、间接、附带、特殊、示例性或后果性损害（包括但不限于替代商品或服务的采购、使用损失、数据丢失或利润损失，或业务中断）承担责任，无论这些损害是基于合同、严格责任还是侵权行为（包括疏忽或其他原因）造成的，即使已被告知发生此类损害的可能性。| `--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

环境变量

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

配合配置文件使用

{

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

      }

    }

  }

}

可用工具

读取操作（29 个工具）

get-article、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

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

edit、append、prepend、move、delete、protect、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             # 运行测试

许可协议

版权所有 (c) 2026 Xie Youtian

在遵守以下条件的前提下，允许以源代码和二进制形式重新分发和使用，无论是否修改：

1. 源代码的再分发必须保留上述版权声明、此条件列表以及以下免责声明。

2. 二进制形式的再分发必须在随附的文档和/或其他材料中重现上述版权声明、此条件列表以及以下免责声明。

本软件由版权所有者和贡献者“按原样”提供，任何明示或暗示的保证，包括但不限于适销性和特定用途适用性的默示保证，均不予承担。在任何情况下，版权所有者或贡献者均不对因使用本软件而引起的任何直接、间接、偶发、特殊、惩戒性或后果性损害（包括但不限于替代商品或服务的采购、使用损失、数据丢失或利润损失，或业务中断）负责，无论这些损害是如何引起的，也无论责任理论是合同、严格责任还是侵权（包括疏忽或其他原因），即使已被告知此类损害的可能性。