MediaWiki MCP Server

社区

让 AI 通过 MCP 连接并操作 MediaWiki。

分类: 其他第 16 / 230
Stars: ★ 143 非常热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js · Docker
凭据: 可选 API Key
许可证: MIT
最近提交: 7 天前
工具数: 46

69FMRS · C

来源显示该项目为 MIT 许可、版本 0.15.0 的 MediaWiki MCP Server，提供 stdio 和 StreamableHTTP 传输、广泛的 MediaWiki 读写工具及多个扩展工具包。它适合已明确配置 wiki、认证和权限边界的 AI 工作流；不应将其视为 MediaWiki 官方服务器。

最强项 · 文档质量 17/20 最弱项 · 可靠性 10/20

可靠性

10/20

安全与权限

14/20

维护活跃度

13/20

文档质量

17/20

安装易用性

15/20

查看各项评分依据

可靠性 10/20: 清单、README 与工具分类基本一致，声明了 stdio/HTTP、错误边界、请求体和响应大小限制，并描述了认证与扩展工具的条件注册，因此初始化和工具列表流程看起来合理。扣分原因是仅提供静态清单和文档，没有源代码、CI 工作流、提交记录或已提交测试来验证 MCP 初始化、工具行为、依赖和异常路径；按静态校准不能超过 12 分。
安全与权限 14/20: 证据显示凭据不会暴露在资源内容中，OAuth 支持令牌存储，写工具按权限区分，上传目录默认关闭，并有 SSRF、Host/Origin 和请求大小防护说明。扣分原因是删除、移动、覆盖和上传等副作用工具未显示需要单独确认；HTTP 模式会转发 Bearer 令牌且安全性依赖反向代理正确配置，此外缺少源代码级数据流和权限实现验证，因此不能给满分。
维护活跃度 13/20: 项目声明使用 MIT 许可证，提供了版本化的 0.15.0 发布包、GitHub 仓库、漏洞报告入口、SECURITY.md、发布文档和明确的维护者组织。扣分原因是用户提供的材料没有提交历史、发布日期、依赖更新记录、问题响应情况或持续维护证据；星标和开放问题只能作为发现信号，不能加分。
文档质量 17/20: README 提供了较完整的工具清单、读写权限、扩展条件、资源格式、配置示例、多种客户端安装方式、OAuth 方案、环境变量、部署、安全检查、上传和 SSRF 限制，并链接到配置、部署、运维和发布文档。扣分原因是完整的参数细节、故障排查、成本影响和实际运行结果主要依赖未提供内容，且仅凭 README 和 manifest 无法验证文档与实现完全一致。
安装易用性 15/20: 文档覆盖 npx、mcpb、插件和多个主流客户端，并提供标准配置、默认目标和配置文件示例；stdio 默认值和 HTTP 端口也已声明。扣分原因是需要 Node/npx、配置文件和私有 wiki 的额外认证设置，HTTP 部署还依赖代理与安全环境变量；没有可验证的安装或端到端执行证据，因此按静态校准取上限 15 分。

静态评测 · 未实际运行收录于 2026-07-30

查看 FMRS 评分方法 →

选型与风险

能访问什么读取本地文件写入 / 删除本地文件访问网络修改第三方账户数据

适合谁

需要让 AI 访问一个或多个 MediaWiki wiki 的团队。
需要同时进行 wiki 内容检索和受控内容维护的用户。
使用支持 MCP 的 Claude、Codex、VS Code、Cursor 或其他列出客户端的用户。

不适合谁

不使用 MediaWiki 的知识库或内容系统。
需要无需配置或无需权限即可执行写入操作的场景。
希望服务器自动提供未在来源中说明的客户端或协议兼容性的用户。

所需权限

读取操作可用于公开或已配置可访问的 wiki。
写入工具需要对应的 MediaWiki 权限；写工具在默认 wiki 为只读时会从 tools/list 隐藏。
文件上传需要配置允许的上传目录。
Cargo 查询可能需要 runcargoqueries 用户权限。
私有 wiki 和认证操作需要 OAuth、令牌、机器人密码或其他配置的认证方式。

风险与副作用

HTTP 模式会将 Authorization Bearer 令牌转发给 MediaWiki，因此应由反向代理负责认证并在不受信任网络外终止 TLS。
公开 HTTP 服务前应配置允许的主机和来源，以降低 DNS 重绑定和跨来源攻击风险。
写入、删除、移动和上传操作可能改变 wiki 内容或文件，凭据应遵循最小权限原则。
外部 URL 获取和上传受 SSRF 与大小限制影响；内部目标需要加入 MCP_TRUSTED_HOSTS。
工具响应存在内容、文件数据、请求体和上传大小上限。

安装接入

准备工作

运行环境：Node.js · Docker

其他可选配置项（17 个）

CONFIG 可选指向config.的路径，用于配置wiki连接与认证；不设则默认英文维基百科，读公开wiki非必需。

MCP_TRANSPORT 可选选择stdio或http传输方式，默认stdio。

MCP_LOG_LEVEL 可选日志最低严重级别，可选debug到silent，默认debug。

MCP_CONTENT_MAX_BYTES 可选 get-page、get-pages、parse-wikitext、compare-pages返回内容的字节上限，默认50000。

MCP_FILE_DATA_MAX_BYTES 可选 get-file-data响应base64大小的硬上限，默认1000000。

MCP_UPLOAD_MAX_BYTES 可选 upload-file-from-url/update-file-from-url服务端抓取的内存上限，超过则改走wiki自身copy-upload，默认104857600。

MCP_OAUTH_CREDENTIALS_FILE 可选覆盖OAuth凭据存储路径，默认~/.config/mediawiki-mcp/credentials.（Windows为%APPDATA%下）。

MCP_OAUTH_NO_BROWSER 可选设为1则OAuth流程不启动浏览器，仅把授权URL输出到stderr，适合无头环境。

MCP_ALLOW_STATIC_FALLBACK 可选设为true才允许在config.含静态凭据时启动HTTP传输。

MCP_MAX_REQUEST_BODY 可选 HTTP传输的最大请求体大小，如1mb，默认1mb。

MCP_METRICS 可选设为true则在HTTP传输下暴露Prometheus /metrics端点。

MCP_OAUTH_ALLOWED_REDIRECTS 可选托管OAuth代理额外允许的重定向URI，逗号分隔。

MCP_OAUTH_CIMD_ALLOWED_HOSTS 可选 CIMD额外信任的client_id文档主机列表。

MCP_OAUTH_PROXY_STORE_FILE 可选托管OAuth代理加密状态文件路径，使登录在重启后仍有效。

MCP_PUBLIC_URL 可选反代改写Host时覆盖保护资源发现文档中使用的公开URL。

MCP_SHUTDOWN_GRACE_MS 可选 SIGTERM/SIGINT时等待在途/mcp请求排空的最长毫秒数，默认10000。

PORT 可选 StreamableHTTP传输使用的端口，默认3000。

可使用 npm 包通过 npx 启动：npx -y @professional-wiki/mediawiki-mcp-server@latest。将 CONFIG 设置为配置文件路径；未提供配置时目标为 English Wikipedia。也可下载 MediaWiki-MCP-Server.mcpb 安装，或按客户端文档添加标准 MCP 配置。HTTP 模式需将 MCP_TRANSPORT 设置为 http，并可通过 PORT 配置端口。

.mcp.json

{"mcpServers":{"mediawiki-mcp-server":{"command":"npx","args":["-y","@professional-wiki/mediawiki-mcp-server@latest"],"env":{"CONFIG":"path/to/config.json"}}}}

以 Claude Code 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "mediawiki-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@professional-wiki/mediawiki-mcp-server@latest"
      ],
      "env": {
        "CONFIG": "path/to/config.json"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add mediawiki-mcp-server -e CONFIG=path/to/config.json -- npx -y @professional-wiki/mediawiki-mcp-server@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

安装后在客户端工具列表中应出现 get-page、search-page 等工具；让AI调用 get-site-info 查询默认wiki，能返回sitename和MediaWiki版本即证明连接成功。

常见排障

确认 CONFIG 指向有效的 JSON 配置文件，并检查 wiki 的 server、articlepath 和 scriptpath。
未配置 CONFIG 时确认目标是否应为 English Wikipedia。
认证失败时检查 OAuth 配置、令牌或机器人密码及所需 MediaWiki 权限。
HTTP 模式检查 MCP_TRANSPORT、PORT、反向代理公开 URL、允许的主机和来源设置。
上传失败时检查 uploadDirs 或 MCP_UPLOAD_DIRS、文件大小限制及目标 wiki 的上传权限。
扩展工具未出现时确认目标 wiki 已安装对应扩展，并检查 Cargo 的 runcargoqueries 权限。

试试这样问

连接成功后，可以直接对 AI 助手这样说：

搜索英文维基百科上关于Model Context Protocol的页面并总结第一篇的内容
获取Wikipedia:Village pump最近50条修订的历史记录
对比Main页两个版本之间的差异
列出en.wikipedia.org这个wiki的站点信息，包括MediaWiki版本和已安装扩展

工具能力 46

compare-pages 只读

按修订、标题或提供的 wikitext 比较 wiki 页面的两个版本。

get-category-members 只读

列出分类成员；每次最多 500 项，可分页。

get-file 只读

获取文件页面。

get-file-data 只读

以内联 base64 图像数据获取文件，供视觉分析；可通过 width 设置缩放。

get-links-here 只读

列出链接到、嵌入或显示指定页面的页面，并支持重定向关系。

get-page 只读

获取 wiki 页面。

get-page-history 只读

列出 wiki 页面的近期修订。

get-pages 只读

一次获取多个 wiki 页面，最多 50 个。

展开其余 38 个工具

get-recent-changes 只读

列出 wiki 的近期变更，可按时间、命名空间、用户、标签、类型和隐藏标志筛选。

get-revision 只读

获取页面的指定修订。

get-site-info 只读

获取 wiki 的关键设置，包括 MediaWiki 版本、语言、命名空间、扩展、许可证和可选统计信息。

list-wikis 只读

列出已配置的 wiki、可达性、只读状态、默认状态、可用扩展工具和 OAuth 授权服务器。

parse-wikitext 只读

在不保存的情况下将 wikitext 渲染为 HTML，并返回警告、内部链接、模板和外部 URL。

search-page 只读

搜索 wiki 页面标题和内容。

search-page-by-prefix 只读

按前缀搜索页面标题。

whoami 只读

报告当前会话在目标 wiki 上认证的身份、用户名、匿名状态和用户组，可选返回用户权限。

create-page 写入

创建新的 wiki 页面；需要创建、编辑和移动页面权限。

delete-page 破坏性

删除 wiki 页面；需要删除页面、修订和日志条目的权限。

move-page 写入

移动或重命名 wiki 页面；需要创建、编辑和移动页面权限。

undelete-page 写入

恢复已删除的 wiki 页面；需要删除页面、修订和日志条目的权限。

update-file 写入

从本地磁盘上传现有文件的新修订；需要上传、替换和移动文件权限。

update-file-from-url 写入

从 URL 上传现有文件的新修订；需要上传、替换和移动文件权限。

update-page 写入

更新现有 wiki 页面；需要编辑现有页面权限。

upload-file 写入

从本地磁盘向 wiki 上传文件；需要上传新文件权限。

upload-file-from-url 写入

从 URL 向 wiki 上传文件；需要上传、替换和移动文件权限。

add-wiki 写入

通过 URL 将 wiki 添加为 MCP 资源；需要启用 wiki 管理。

remove-wiki 写入

移除 wiki 资源；需要启用 wiki 管理且至少配置两个 wiki。

oauth-logout 写入

移除已存储的 OAuth 令牌；仅支持 stdio。

oauth-status 只读

列出已存储 OAuth 令牌的作用域和有效期，不显示令牌值；仅支持 stdio。

neowiki-list-schemas 只读

列出 NeoWiki 模式及其属性数量。

neowiki-get-schema 只读

获取一个 NeoWiki 模式的属性定义、关系和选项。

neowiki-cypher-query 只读

对 NeoWiki 知识图谱运行只读 Cypher 查询。

neowiki-search-subjects 只读

在指定模式中按标签查找主体 ID。

neowiki-get-subject 只读

按 ID 获取一个主体的结构化数据。

neowiki-get-page-subjects 只读

列出附加到 wiki 页面的主体。

neowiki-create-subject 写入

在页面上创建主体；需要 edit 权限。

neowiki-update-subject 写入

替换主体的标签和陈述；需要 edit 权限。

neowiki-delete-subject 破坏性

按 ID 删除主体；需要 edit 权限。

neowiki-set-main-subject 写入

设置或清除页面的主主体；需要 edit 权限。

neowiki-validate-subject 只读

试运行验证主体并返回违规项。

smw-list-properties 只读

列出 Semantic MediaWiki 属性，并提供可复制到 smw-query 的模板。

smw-query 只读

运行 Semantic MediaWiki #ask 查询。

bucket-query 只读

运行 Bucket Lua 查询。

cargo-list-tables 只读

列出 wiki 中定义的 Cargo 表。

cargo-describe-table 只读

列出 Cargo 表的字段、类型和列表标志。

cargo-query 只读

运行 Cargo SQL 风格查询。

使用场景

查询和检索 MediaWiki 页面、修订、分类成员及近期变更。

比较页面版本并解析 wikitext。

在具备权限时创建、编辑、移动、删除页面和管理文件。

让 AI 查询 Semantic MediaWiki、Cargo、Bucket 或 NeoWiki 数据。

支持客户端

Claude Code

Codex

Claude Desktop

VS Code

Cursor

Antigravity

OpenCode

Devin Desktop

Zed

LM Studio

依据项目文档列出，未经本站实测。

详细介绍

MediaWiki MCP Server 是由 ProfessionalWiki 维护的 MCP 服务器，可让大型语言模型客户端通过标准工具与任意 MediaWiki wiki 交互。它支持页面读取、搜索、历史与差异查看、解析 wikitext，以及创建、编辑、移动、删除页面和上传文件等写入操作；还提供多 wiki 资源、OAuth 工具，以及针对 NeoWiki、Semantic MediaWiki、Bucket 和 Cargo 扩展的工具包。默认面向 English Wikipedia；连接私有 wiki 或执行需要认证的操作时需要配置文件和相应凭据。