MediaWiki MCP Server

Official

by ProfessionalWiki · TypeScript

MCP server enabling AI clients to interact with any MediaWiki wiki through standard tools

io.github.ProfessionalWiki/mediawiki-mcp-server (MCP Server)

An MCP (Model Context Protocol) server that enables AI/LLM clients to interact with any MediaWiki wiki through standard MCP tools. It is published as @professional-wiki/mediawiki-mcp-server and supports MediaWiki access for agent/tool workflows.

🛠️ Key Features

Operates as an MCP server for MediaWiki
Provides tools for wiki interaction
Most tools accept an optional wiki argument to select the wiki to act on
Wiki-management and OAuth tools do not accept the wiki argument

🚀 Use Cases

Connecting an AI client to a MediaWiki instance
Using agent tools to perform actions against a specified wiki

⚡ Developer Benefits

Standard Model Context Protocol server for tool-based integrations
Wiki selection via optional wiki parameter (where supported)

⚠️ Limitations

wiki argument is not supported for wiki-management and OAuth tools

Topics

mcp-servermediawikimodel-context-protocol-serversagentsllmsmcpmodel-context-protocolmodelcontextprotocolaiai-agent-toolsgemini-cli-extension

README.md21 KBView on GitHub

MediaWiki MCP Server

An MCP (Model Context Protocol) server that enables Large Language Model (LLM) clients to interact with any MediaWiki wiki.

Features

Tools

Every tool that operates on a wiki accepts an optional wiki argument naming the wiki to act on (the wiki-management and OAuth tools do not) — pass a wiki key (e.g. en.wikipedia.org) or the full mcp://wikis/{wikiKey} URI. Omit it to use the configured default wiki (see Configuration). Each tool response reports the wiki the call ran against. Each successful response carries its payload as prose in content and as JSON in structuredContent; see response channels.

Page reads

Name	Description
`compare-pages`	Diff two versions of a wiki page by revision, title, or supplied wikitext.
`get-category-members`	List members of a category (up to 500 per call, paginated via `continueFrom`).
`get-file`	Fetch a file page.
`get-file-data`	Fetch a file's image bytes inline (base64) for visual analysis — for clients that can't reach the wiki host. Returns a scaled rendition (set `width`); non-renderable types (audio, video, binaries) error. For metadata or a download URL, use `get-file`.
`get-links-here`	List pages that reference a wiki page — pages that link to it, embed it as a template, or display it as a file (select via `type`), including pages that reach it through a redirect. Up to 500 per call, paginated via `continueFrom`.
`get-page`	Fetch a wiki page.
`get-page-history`	List recent revisions of a wiki page.
`get-pages`	Fetch multiple wiki pages in one call (up to 50).
`get-recent-changes`	List recent change events across the wiki, filterable by timestamp, namespace, user, tag, type, and hide flags (up to 50 per call, paginated via `continue`).
`get-revision`	Fetch a specific revision of a page.
`get-site-info`	Get a wiki's key settings: MediaWiki version, content language, title-case rules, namespaces, installed extensions, license, and (optionally) statistics.
`list-wikis`	List every configured wiki — its key, sitename, server, whether it is read-only or the default, whether it is reachable, which extension-gated tools work on it, and, for an OAuth-configured wiki, its authorization server. Disabled when fewer than two wikis are configured.
`parse-wikitext`	Render wikitext to HTML without saving. Returns parse warnings, wikilinks, templates, and external URLs.
`search-page`	Search wiki page titles and contents (full-text). Searches the wiki's content namespaces unless given other namespace IDs.
`search-page-by-prefix`	Search page titles by prefix.
`whoami`	Report the identity the current session is authenticated as on the targeted wiki — username, whether it is anonymous, and group memberships (optionally user rights).

Page writes

Name	Description	Permissions
`create-page` 🔐	Create a new wiki page.	`Create, edit, and move pages`
`delete-page` 🔐	Delete a wiki page.	`Delete pages, revisions, and log entries`
`move-page` 🔐	Move (rename) a wiki page.	`Create, edit, and move pages`
`undelete-page` 🔐	Undelete a wiki page.	`Delete pages, revisions, and log entries`
`update-file` 🔐	Upload a new revision of an existing file from local disk.	`Upload, replace, and move files`
`update-file-from-url` 🔐	Upload a new revision of an existing file from a URL.	`Upload, replace, and move files`
`update-page` 🔐	Update an existing wiki page: overwrite it, add to it, or rewrite one passage of it.	`Edit existing pages`
`upload-file` 🔐	Upload a file to the wiki from local disk.	`Upload new files`
`upload-file-from-url` 🔐	Upload a file to the wiki from a URL.	`Upload, replace, and move files`

Wiki management

Name	Description
`add-wiki`	Add a wiki as an MCP resource from its URL. Disabled when `allowWikiManagement` is `false`.
`remove-wiki`	Remove a wiki resource. Disabled when `allowWikiManagement` is `false` or fewer than two wikis are configured.

OAuth

Name	Description
`oauth-logout`	Remove stored OAuth tokens. Stdio only.
`oauth-status`	List stored OAuth tokens with scopes and expiry (no token values). Stdio only.

Extension packs

Each pack's tools register only on wikis where its extension is installed.

NeoWiki

Name	Description
`neowiki-list-schemas`	List schemas (entity types) and their property counts.
`neowiki-get-schema`	Get one schema's property definitions, relations, and select options.
`neowiki-cypher-query`	Run a read-only Cypher query against the knowledge graph.
`neowiki-search-subjects`	Find subject IDs by label within a schema.
`neowiki-get-subject`	Fetch one subject's structured data by ID.
`neowiki-get-page-subjects`	List the subjects attached to a wiki page.
`neowiki-create-subject`	Create a subject (child or main) on a page. Requires the `edit` right.
`neowiki-update-subject`	Replace a subject's label and statements. Requires the `edit` right.
`neowiki-delete-subject`	Delete a subject by ID. Requires the `edit` right.
`neowiki-set-main-subject`	Set or clear a page's main subject. Requires the `edit` right.
`neowiki-validate-subject`	Dry-run validate a proposed subject and return violations.

Semantic MediaWiki

Name	Description
`smw-list-properties`	List Semantic MediaWiki properties with copy-paste templates for `smw-query`.
`smw-query`	Run a Semantic MediaWiki `#ask` query.

Bucket

Name	Description
`bucket-query`	Run a Bucket Lua query.

Cargo

Name	Description
`cargo-list-tables`	List Cargo tables defined on the wiki.
`cargo-describe-table`	List a Cargo table's fields with their types and list-flags.
`cargo-query`	Run a Cargo SQL-style query.

Wikibase

Name	Description
`wikibase-search-entities`	Find items and properties by label or alias.
`wikibase-get-entity`	Read one entity's terms and statements, with referenced IDs resolved to labels.
`wikibase-query`	Run a SPARQL query against the wiki's query service. Offered only for a repository whose siteinfo publishes one.
`wikibase-edit-entity`	Create or change an entity from Wikibase entity JSON. Requires the `edit` right.
`wikibase-add-statement`	Add one statement with an item, string, external-id or url value. Requires the `edit` right.

Resources

mcp://wikis/{wikiKey} — per-wiki resource exposing sitename, server (the wiki's public address), articlepath, scriptpath, and the private and readOnly flags.

Those fields are the whole of it: the resource publishes a fixed list, so credentials and server-side settings in your configuration file are never exposed in resource content.
After add-wiki or remove-wiki, the server sends notifications/resources/list_changed so clients refresh.

Example read result

json

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

Environment variables

The variables below are relevant to any setup. Variables that only apply when self-hosting the HTTP transport (ports, timeouts, Host/Origin and SSRF guards) or running the hosted OAuth proxy are in docs/deployment.md — environment variables. Config-file substitution and upload-directory variables are in docs/configuration.md.

Name	Description	Default
`CONFIG`	Path to your configuration file	`config.json`
`MCP_TRANSPORT`	Type of MCP server transport (`stdio` or `http`)	`stdio`
`MCP_LOG_LEVEL`	Minimum severity for logger output. One of `debug`, `info`, `notice`, `warning`, `error`, `critical`, `alert`, `emergency`, or `silent`.	`debug`
`MCP_CONTENT_MAX_BYTES`	Byte cap for the content bodies and result blocks tools return (wikitext, rendered HTML, diffs, statement and row listings), applied once per response. Tune to the target LLM client's tool-response budget.	`75000`
`MCP_FILE_DATA_MAX_BYTES`	Hard cap on the base64-encoded size of a `get-file-data` response. A transport/safety backstop; tune the actual size per call with the tool's `width`. Over-cap calls error rather than truncate.	`1000000`
`MCP_UPLOAD_MAX_BYTES`	Memory cap on the server-side fetch used by `upload-file-from-url` / `update-file-from-url`. Files larger than this are handed to the wiki's own copy-upload instead of being buffered by the server. Guards this server's memory, not the wiki's `$wgMaxUploadSize`.	`104857600`
`MCP_OAUTH_CREDENTIALS_FILE`	Override the default credentials store path. Default: `~/.config/mediawiki-mcp/credentials.json` (Linux/macOS) or `%APPDATA%\mediawiki-mcp\credentials.json` (Windows).	`unset`
`MCP_OAUTH_NO_BROWSER`	Set to `1` to skip launching a browser during the OAuth flow; the auth URL is logged to stderr instead. Useful in headless environments.	`unset`

Configuration

NOTE

Config is only required when interacting with a private wiki or using authenticated tools.

Create a config.json file to configure wiki connections. Use the config.example.json as a starting point.

json

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

Internal vs public address. The server you configure may be an internal hostname (e.g. http://mediawiki in Docker); URLs handed back to the caller are built from the wiki's public address, so internal hostnames don't leak into links. See docs/configuration.md — per-wiki fields.

For the full field reference, env-var substitution, secret sources, change tags, upload directories, and authentication options, see docs/configuration.md.

Authentication

Tools marked 🔐 require authentication. Write tools (including extension-pack writes) are hidden from tools/list when the configured default wiki has readOnly: true — see Deployment.

Browser-based OAuth (recommended). Sign in through a browser tab the first time a tool needs auth. Set oauth2ClientId and oauth2CallbackPort per wiki — see docs/configuration.md — OAuth (browser-based).
Per-request bearer token (HTTP), deprecated. Each request carries Authorization: Bearer <token> and the server forwards it to MediaWiki. Off by default, because an MCP server must not accept tokens that were not issued for it. See docs/deployment.md — per-request bearer token.
Hosted OAuth proxy (HTTP). The server fronts one MediaWiki consumer as an OAuth 2.1 Authorization Server, so an OAuth-aware client signs each user in — no manual tokens. Point it at https://<wiki>/mcp; anonymous read still works. See docs/deployment.md — hosted OAuth sign-in.
Manual OAuth2 access token. Paste a long-lived token into config.json. See docs/configuration.md — manual OAuth2 access token.
Bot password. Fallback when Extension:OAuth isn't installed. See docs/configuration.md — bot password.

The Cargo tools (cargo-query, cargo-list-tables, cargo-describe-table) call API actions gated by the runcargoqueries user right. Most wikis grant this to all users by default; wikis that restrict it require the Create, query and delete data through the Cargo extension grant on the bot password or OAuth consumer. The Cargo extension is also detected on wiki.gg-hosted wikis (Helldivers, Terraria, Ark, etc.), where it ships under the rebranded name LIBRARIAN.

Installation

Pick your client below, or use the standard configuration if it is not listed. CONFIG is optional; without it the server targets English Wikipedia. To point it at your own wiki and set up authentication for writes, see docs/configuration.md.

Claude Code

Add this repository as a plugin marketplace, then install the bundled server:

code

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

The plugin takes an optional configuration file, which points the server at your own wiki. Set it from the prompt when enabling the plugin, or at any time with /plugin configure mediawiki-mcp-server@professional-wiki. A command-line install takes the same value via claude plugin install mediawiki-mcp-server@professional-wiki --config configPath=path/to/config.json.

When installed as a plugin, the tools are namespaced mcp__plugin_mediawiki-mcp-server_mediawiki__<tool>; update any tool allowlists or hooks accordingly.

To configure the server directly instead, see the Claude Code MCP docs. The short version:

bash

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

Add this repository as a plugin marketplace, then install the bundled server:

bash

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

To point the plugin at your own wiki, set CONFIG in the shell you launch Codex from, for example export CONFIG=path/to/config.json. Codex has no per-plugin configuration; if you would rather not set an environment variable, codex mcp add mediawiki --env CONFIG=path/to/config.json -- npx -y @professional-wiki/mediawiki-mcp-server@latest registers the server directly and takes precedence over the plugin's copy.

See the Codex plugins documentation for how to list, update, or remove plugins.

Claude Desktop

Download MediaWiki-MCP-Server.mcpb and double-click it to install the extension, which prompts for a configuration file path so you can point it at your own wiki instead of English Wikipedia.

VS Code and Cursor

Or add the standard configuration by hand.

Antigravity

Add the standard configuration to Antigravity's MCP config, either globally in ~/.gemini/config/mcp_config.json or per-workspace in .agents/mcp_config.json.

If you previously installed the Gemini CLI extension, Antigravity's setup wizard offers to import your existing Gemini CLI configuration.

OpenCode

OpenCode uses its own configuration shape rather than mcpServers; add this to opencode.json in your project root, or ~/.config/opencode/opencode.json for a global install.

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

Standard configuration

Most clients read the same server block. Paste it into the file listed for your client, replacing mcpServers with that client's root key:

Client	Configuration file	Root key
Cursor	`~/.cursor/mcp.json`, or `.cursor/mcp.json` per project	`mcpServers`
VS Code	`.vscode/mcp.json` per workspace, or the MCP: Open User Configuration command	`servers`
Devin Desktop (formerly Windsurf)	`~/.codeium/windsurf/mcp_config.json`	`mcpServers`
Zed	`~/.config/zed/settings.json`	`context_servers`
LM Studio	`~/.lmstudio/mcp.json`	`mcpServers`

json

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

For any other client, npx add-mcp @professional-wiki/mediawiki-mcp-server may work: add-mcp is a community CLI that writes your client's configuration file for you. It sets the launch command only; add CONFIG yourself to point at your own wiki.

Deployment

Running the server as a remote HTTP endpoint for other users has its own configuration requirements — see docs/deployment.md. A pre-built image is published at ghcr.io/professionalwiki/mediawiki-mcp-server. For day-2 operations (logs, /health//ready, metrics, graceful shutdown), see docs/operations.md.

Security

Defaults are safe for single-user use. Before exposing the HTTP transport to others, lock down three things:

Terminate TLS at your reverse proxy. Don't expose the MCP port directly on an untrusted network. See docs/deployment.md — security checklist.
Pair MCP_BIND with MCP_ALLOWED_HOSTS and MCP_ALLOWED_ORIGINS. The HTTP transport binds to 127.0.0.1 by default. When you open it up with MCP_BIND=0.0.0.0, set MCP_ALLOWED_HOSTS to the hostnames your proxy forwards and MCP_ALLOWED_ORIGINS to the browser origins allowed to call the server — these block DNS-rebinding and cross-origin attacks respectively.
Uploads are opt-in. upload-file is disabled until you list allowed directories in uploadDirs or MCP_UPLOAD_DIRS. See docs/configuration.md — upload directories.
Internal destinations need MCP_TRUSTED_HOSTS. Outbound fetches are SSRF-guarded: a destination resolving to a private or loopback address (e.g. a Docker-network alias like mediawiki.svc) is refused until you list its host in MCP_TRUSTED_HOSTS. See docs/deployment.md — outbound SSRF guard.

Report a vulnerability via GitHub's security advisory form — full policy in SECURITY.md.

Contributing

Contributions are welcome — pull requests and issues (bugs, feature requests, suggestions) both work.

Working on tool code? Start from AGENTS.md for repo layout, commands, and testing patterns.
Adding or modifying a tool? Read docs/tool-conventions.md — it covers description voice, parameter docs, annotation hints, and MediaWiki terminology conventions.
Running a release? See docs/releasing.md.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Install

Configuration

Environment variables

CONFIGdefault config.json

Path to your configuration file

MCP_ALLOW_STATIC_FALLBACK

Set to 'true' to allow HTTP startup when config.json has static credentials. Otherwise the server refuses to start, preventing silent shared-identity fallback for unauthenticated requests.

MCP_CONTENT_MAX_BYTESdefault 75000

Byte cap for the content bodies and result blocks tools return (wikitext, rendered HTML, diffs, statement and row listings). An oversized response is truncated with a trailing marker describing what was left out.

MCP_FILE_DATA_MAX_BYTESdefault 1000000

Hard cap on the base64-encoded size of a get-file-data response. A transport/safety backstop; callers tune actual size with the tool's width parameter. Over-cap responses error rather than truncate.

MCP_LOG_LEVELdefault debug

Minimum severity for logger output (stderr telemetry and sendLoggingMessage broadcast). Invalid values fail loudly on first log call.

MCP_MAX_REQUEST_BODYdefault 1mb

Maximum HTTP request body size on the StreamableHTTP transport. Accepts size strings like 1mb or 512kb.

MCP_METRICS

Set to 'true' to expose Prometheus metrics at GET /metrics on the HTTP transport. Has no effect on the stdio transport.

MCP_OAUTH_ALLOWED_REDIRECTS

Additional allowed redirect URIs for hosted-proxy client registration: comma-separated exact URIs (which must include a host) and https prefix patterns ending in /*. Loopback, claude.ai, and verified first-party clients (ChatGPT, Cursor, VS Code) are always allowed; unset means no additional clients.

MCP_OAUTH_CIMD_ALLOWED_HOSTS

Comma-separated additional client_id document hosts trusted for CIMD (bare host or host:port). Verified first-party hosts are always trusted.

MCP_OAUTH_CREDENTIALS_FILE

Override the default OAuth credentials store path. Default: ~/.config/mediawiki-mcp/credentials.json on Linux/macOS, %APPDATA%\mediawiki-mcp\credentials.json on Windows.

MCP_OAUTH_NO_BROWSER

Set to '1' to skip launching a browser during the OAuth dance and log the auth URL to stderr instead. Useful in headless environments and CI.

MCP_OAUTH_PROXY_STORE_FILE

Path to the hosted OAuth proxy's encrypted state file, which lets sign-ins survive restarts. Default: proxy-store.enc under the mediawiki-mcp config dir; /app/data/proxy-store.enc in the Docker image.

MCP_PUBLIC_URL

Override the request-derived public URL used in the protected-resource discovery doc and WWW-Authenticate header. Set this when running behind a proxy that rewrites the request Host.

MCP_SHUTDOWN_GRACE_MSdefault 10000

Maximum milliseconds to wait for in-flight /mcp calls to drain on SIGTERM/SIGINT before exiting. Capped at 600000.

MCP_TRANSPORTdefault stdio

Type of MCP server transport

MCP_UPLOAD_MAX_BYTESdefault 104857600

Memory cap on the server-side fetch used by upload-file-from-url and update-file-from-url. Files larger than this are routed to the wiki's own copy-upload instead of being buffered by the server. Guards this server's memory, not the wiki's $wgMaxUploadSize.

PORTdefault 3000

Port used for StreamableHTTP transport

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mediawiki-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@professional-wiki/mediawiki-mcp-server@0.18.0"
      ],
      "env": {
        "CONFIG": "config.json",
        "MCP_ALLOW_STATIC_FALLBACK": "<YOUR_MCP_ALLOW_STATIC_FALLBACK>",
        "MCP_CONTENT_MAX_BYTES": "75000",
        "MCP_FILE_DATA_MAX_BYTES": "1000000",
        "MCP_LOG_LEVEL": "debug",
        "MCP_MAX_REQUEST_BODY": "1mb",
        "MCP_METRICS": "<YOUR_MCP_METRICS>",
        "MCP_OAUTH_ALLOWED_REDIRECTS": "<YOUR_MCP_OAUTH_ALLOWED_REDIRECTS>",
        "MCP_OAUTH_CIMD_ALLOWED_HOSTS": "<YOUR_MCP_OAUTH_CIMD_ALLOWED_HOSTS>",
        "MCP_OAUTH_CREDENTIALS_FILE": "<YOUR_MCP_OAUTH_CREDENTIALS_FILE>",
        "MCP_OAUTH_NO_BROWSER": "<YOUR_MCP_OAUTH_NO_BROWSER>",
        "MCP_OAUTH_PROXY_STORE_FILE": "<YOUR_MCP_OAUTH_PROXY_STORE_FILE>",
        "MCP_PUBLIC_URL": "<YOUR_MCP_PUBLIC_URL>",
        "MCP_SHUTDOWN_GRACE_MS": "10000",
        "MCP_TRANSPORT": "stdio",
        "MCP_UPLOAD_MAX_BYTES": "104857600",
        "PORT": "3000"
      }
    }
  }
}

io.github.ProfessionalWiki/mediawiki-mcp-server (MCP Server)

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

Topics

MediaWiki MCP Server

Features

Tools

Page reads

Page writes

Wiki management

OAuth

Extension packs

Resources

Environment variables

Configuration

Authentication

Installation

Claude Code

Codex

Claude Desktop

VS Code and Cursor

Antigravity

OpenCode

Standard configuration

Deployment

Security

Contributing

License

Install

Configuration

Related servers