MediaWiki MCP Server

MediaWiki MCP Server

一个 MCP（Model Context Protocol）服务，使大模型（LLM）客户端能够与任意 MediaWiki wiki 交互。

功能

工具

所有操作 wiki 的工具都接受可选的 wiki 参数，用于指定要操作的 wiki（wiki 管理和 OAuth 工具除外）——传入 wiki 键（例如 en.wikipedia.org）或完整的 mcp://wikis/{wikiKey} URI。省略此参数则使用已配置的默认 wiki（参见配置）。每个工具响应都会报告此次调用所针对的 wiki。每个成功响应都会在 content 中以文字形式、在 structuredContent 中以 JSON 形式提供有效负载；参见响应渠道。

页面读取

页面写入

Wiki 管理

OAuth

扩展包

每个扩展包的工具仅会在安装了该扩展的 Wiki 上注册。

NeoWiki

Semantic MediaWiki

Bucket

Cargo

Wikibase

资源

mcp://wikis/{wikiKey} — 每个 Wiki 的资源，提供 sitename、server（Wiki 的公开地址）、articlepath、scriptpath 以及 private 和 readOnly 标记。

• 资源仅包含这些字段：它发布的是固定列表，因此配置文件中的凭据和服务器端设置绝不会暴露在资源内容中。
• 执行 add-wiki 或 remove-wiki 后，服务端会发送 notifications/resources/list_changed，以便客户端刷新。

{
  "contents": [
    {
      "uri": "mcp://wikis/en.wikipedia.org",
      "mimeType": "application/json",
      "text": "{ \"sitename\":\"Wikipedia\",\"server\":\"https://en.wikipedia.org\",\"articlepath\":\"/wiki\",\"scriptpath\":\"/w\",\"private\":false }"
    }
  ]
}

以下变量适用于任何配置。仅在自托管 HTTP 传输（端口、超时、Host/Origin 和 SSRF 防护）或运行托管 OAuth 代理时适用的变量，见 docs/deployment.md — environment variables。配置文件替换和上传目录变量见 docs/configuration.md。

配置

说明

仅在与私有 wiki 交互或使用经过身份验证的工具时才需要配置。

创建 config.json 文件以配置 wiki 连接。可从 config.example.json 开始配置。

{
  "defaultWiki": "en.wikipedia.org",
  "wikis": {
    "en.wikipedia.org": {
      "sitename": "Wikipedia",
      "server": "https://en.wikipedia.org",
      "articlepath": "/wiki",
      "scriptpath": "/w"
    }
  }
}

内部地址与公开地址。 配置的 server 可以是内部主机名（例如 Docker 中的 http://mediawiki）；返回给调用方的 URL 根据 wiki 的公开地址构建，因此内部主机名不会泄露到链接中，前提是已将内部主机列入 MCP_TRUSTED_HOSTS。请参阅 docs/configuration.md — per-wiki fields。

完整的字段参考、环境变量替换、机密来源、变更标签、上传目录和身份验证选项，请参阅 docs/configuration.md。

身份验证

标有 🔐 的工具需要身份验证。对于设置了 readOnly: true 的 wiki，写入工具（包括扩展包写入工具）会被拒绝；如果所有已配置的 wiki 都设置了此项，这些工具也会从 tools/list 中隐藏 — 参见部署。

• 基于浏览器的 OAuth（推荐）。 首次有工具需要身份验证时，通过浏览器标签页登录。为每个 wiki 设置 oauth2ClientId 和 oauth2CallbackPort — 参见 docs/configuration.md — OAuth（基于浏览器）。
• 按请求提供 Bearer 令牌（HTTP），已弃用。 每个请求都携带 Authorization: Bearer <token>，服务会将其转发给 MediaWiki。默认关闭，因为 MCP 服务不得接受并非为其签发的令牌。参见 docs/deployment.md — 按请求提供 Bearer 令牌。
• 托管 OAuth 代理（HTTP）。 服务将一个 MediaWiki 消费者接入为 OAuth 2.1 授权服务器，因此支持 OAuth 的客户端可以为每位用户完成登录 — 无需手动提供令牌。将其指向 https://<wiki>/mcp；匿名读取仍可使用。参见 docs/deployment.md — 托管式 OAuth 登录。
• 手动提供 OAuth2 访问令牌。 将长期有效的令牌粘贴到 config.json 中。参见 docs/configuration.md — 手动提供 OAuth2 访问令牌。
• 机器人密码。 未安装 Extension:OAuth 时的备用方案。参见 docs/configuration.md — 机器人密码。

即使 wiki 允许所有用户运行 Cargo 查询，cargo-query 仍需要机器人密码或 OAuth 消费者具有 Create, query and delete data through the Cargo extension 授权。该工具也会在 wiki.gg 的 wiki 上检测 Cargo 扩展；这些 wiki 运行的是 Cargo 的 wiki.gg 分支 LIBRARIAN。

安装

选择下方的客户端；如果未列出，请使用标准配置。CONFIG 是可选项；未设置时，服务会连接到英文 Wikipedia。若要将其指向自己的 wiki 并为写入配置身份验证，请参见 docs/configuration.md。

Claude Code

将此仓库添加为插件市场，然后安装捆绑的服务：

/plugin marketplace add ProfessionalWiki/MediaWiki-MCP-Server
/plugin install mediawiki-mcp-server@professional-wiki

插件可选接收一个配置文件，用于将服务指向自己的 wiki。启用插件时，在提示中设置该文件；也可以随时使用 /plugin configure mediawiki-mcp-server@professional-wiki 设置。通过命令行安装时，可使用相同的值：claude plugin install mediawiki-mcp-server@professional-wiki --config configPath=path/to/config.json。

作为插件安装时，工具的命名空间为 mcp__plugin_mediawiki-mcp-server_mediawiki__<tool>；请相应更新任何工具允许列表或钩子。

若要直接配置服务，请参见 Claude Code MCP 文档。简要步骤如下：

claude mcp add mediawiki-mcp-server -- npx -y @professional-wiki/mediawiki-mcp-server@latest
# Environment variables go before the `--`:
claude mcp add mediawiki-mcp-server -e CONFIG=path/to/config.json -- npx -y @professional-wiki/mediawiki-mcp-server@latest

Codex

将此仓库添加为插件市场，然后安装捆绑的服务：

codex plugin marketplace add ProfessionalWiki/MediaWiki-MCP-Server
codex plugin add mediawiki-mcp-server@professional-wiki

若要将插件指向自己的 wiki，请在启动 Codex 的 shell 中设置 CONFIG，例如 export CONFIG=path/to/config.json。Codex 不支持按插件单独配置；如果不想设置环境变量，可以直接运行 codex mcp add mediawiki --env CONFIG=path/to/config.json -- npx -y @professional-wiki/mediawiki-mcp-server@latest 注册服务，这会优先于插件中的副本。

有关列出、更新或移除插件的方法，请参见 Codex 插件文档。

Claude Desktop

下载 MediaWiki-MCP-Server.mcpb，然后双击安装扩展。安装时会提示输入配置文件路径，以便将其指向自己的 wiki，而不是英文 Wikipedia。

VS Code 和 Cursor

或者手动添加标准配置。

Antigravity

将标准配置添加到 Antigravity 的 MCP 配置中，可以添加到全局配置文件 ~/.gemini/config/mcp_config.json，也可以添加到工作区配置文件 .agents/mcp_config.json。

如果你之前安装过 Gemini CLI 扩展，Antigravity 的设置向导会提供导入现有 Gemini CLI 配置的选项。

OpenCode

OpenCode 使用自己的配置格式，而不是 mcpServers；请将以下内容添加到项目根目录中的 opencode.json，或者全局安装时添加到 ~/.config/opencode/opencode.json。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mediawiki-mcp-server": {
      "type": "local",
      "command": ["npx", "-y", "@professional-wiki/mediawiki-mcp-server@latest"],
      "environment": {
        "CONFIG": "path/to/config.json"
      }
    }
  }
}

标准配置

大多数客户端读取相同的服务配置块。将其粘贴到客户端对应的文件中，并将 mcpServers 替换为该客户端的根键：

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

对于其他客户端，npx add-mcp @professional-wiki/mediawiki-mcp-server 可能有效：add-mcp 是一个社区 CLI，可为你写入客户端的配置文件。它只会设置启动命令；请自行添加 CONFIG，以指向你自己的 wiki。

部署

将服务作为远程 HTTP 端点运行并提供给其他用户时，有单独的配置要求——请参阅 docs/deployment.md。预构建镜像发布于 ghcr.io/professionalwiki/mediawiki-mcp-server。有关第 2 天运维（日志、/health//ready、指标、优雅关闭），请参阅 docs/operations.md。

安全

默认设置适用于单用户使用。在向他人开放 HTTP 传输之前，请做好以下三项防护：

• 在反向代理处终止 TLS。 不要在不受信任的网络上直接暴露 MCP 端口。请参阅 docs/deployment.md — security checklist。
• 将 MCP_BIND 与 MCP_ALLOWED_HOSTS 和 MCP_ALLOWED_ORIGINS 配套设置。 HTTP 传输默认绑定到 127.0.0.1。使用 MCP_BIND=0.0.0.0 对外开放时，请将 MCP_ALLOWED_HOSTS 设为代理转发的主机名，并将 MCP_ALLOWED_ORIGINS 设为允许调用服务的浏览器来源——两者分别用于阻止 DNS 重绑定攻击和跨源攻击。
• 上传功能默认关闭。 在 uploadDirs 或 MCP_UPLOAD_DIRS 中列出允许的目录后，才能使用 upload-file。请参阅 docs/configuration.md — upload directories。
• 内部目标需要配置 MCP_TRUSTED_HOSTS。 出站请求受 SSRF 防护：如果目标解析到私有或环回地址（例如 mediawiki.svc 这样的 Docker 网络别名），则会被拒绝，除非将其主机名列入 MCP_TRUSTED_HOSTS。请参阅 docs/deployment.md — outbound SSRF guard。

通过 GitHub 的安全公告表单报告漏洞——完整政策请参阅 SECURITY.md。

贡献

欢迎贡献——无论是提交拉取请求还是问题（错误、功能请求、建议），都可以。

• 要处理工具代码？ 请从 AGENTS.md 开始，了解仓库布局、命令和测试模式。
• 要添加或修改工具？ 请阅读 docs/tool-conventions.md——其中介绍了描述的写作风格、参数文档、注释提示以及 MediaWiki 术语规范。
• 要发布版本？ 请参阅 docs/releasing.md。

许可证

本项目采用 MIT 许可证。详情请参阅 LICENSE 文件。