io.github.olgasafonova/mediawiki-mcp-server

Official

by olgasafonova · Go

MediaWiki

Search, read, and edit any MediaWiki wiki. Works with Wikipedia, Fandom, and more.

Search, read, and edit any MediaWiki instance including Wikipedia and Fandom wikis.

Topics

starredanthropicclaudegogolangmcpmcp-servermediawikimodel-context-protocolwikiwikipedia

README.md9 KBView on GitHub

MediaWiki MCP Server

Connect your AI assistant to any MediaWiki wiki, or script it directly from the terminal. Search, read, and edit wiki content using natural language or the wiki CLI.

Three ways to use it:

MCP server — Claude Desktop, Claude Code, Cursor, ChatGPT, n8n, VS Code, Google ADK, or any MCP-compatible tool. See SETUP.md.
wiki CLI — same API client, same auth, no AI needed. For shell pipelines, CI checks, cron jobs. See CLI.md.
Claude Code plugin — /plugin marketplace add olgasafonova/mediawiki-mcp-server adds wiki skills directly to Claude Code. See .claude-plugin/README.md.

Documentation

Document	What it covers
QUICKSTART.md	Get running in 2 minutes
SETUP.md	Per-tool configuration (Claude Desktop, Cursor, ChatGPT, n8n, VS Code, Google ADK)
CLI.md	`wiki` command-line reference
TOOLS.md	Full tool reference (43 tools by category)
DEPLOYMENT.md	HTTP transport, security, endpoints, env vars
TIETO_SETUP.md	Connect to Tieto's Public 360° Wiki (beginner-friendly)
WIKI_USE_CASES.md	Detailed workflows by persona
ARCHITECTURE.md	System design
CONTRIBUTING.md	How to contribute
SECURITY.md	Security policies
CHANGELOG.md	Version history

What Can You Do?

The same operation works from a prompt (via MCP) or directly in your shell (via the wiki CLI):

Goal	Prompt your AI	From your terminal
Search the wiki	"What does our wiki say about onboarding?"	`wiki search "onboarding"`
Read a page	"Show me the Getting Started page"	`wiki page "Getting Started"`
Find broken links	"Are there broken links on the Docs page?"	`wiki links broken --json`
Find stale content	"Which pages haven't been updated in 90 days?"	`wiki stale-pages --days 90`
Cross-link suggestions	"What pages are similar to the API Reference?"	`wiki similar "API Reference"`
Audit wiki health	"Run a health check on the wiki"	`wiki audit --json`
Publish markdown	"Publish this README to the wiki"	`wiki publish README.md "Page Title"`
Strike a name	"Strike out John Smith on the Team page"	`wiki replace "Team" --find "John Smith" --replace "<s>John Smith</s>"`

For the full tool list, see TOOLS.md. The CLI returns typed exit codes for CI-friendly branching — see CLI.md.

30-Second Start

Get the binary. Download from Releases or go build -o mediawiki-mcp-server . (requires Go 1.24+).
Find your wiki API URL — usually https://your-wiki.com/api.php. Wikipedia is https://en.wikipedia.org/w/api.php. Visit Special:Version to confirm.
Wire it up to your AI tool — see SETUP.md for the configuration that matches your client.

Reading public wikis works without login. Private/corporate wikis and editing require a bot password — SETUP.md#editing-wiki-pages.

Example Prompts

📖 More examples: see WIKI_USE_CASES.md for detailed workflows by persona (content editors, documentation managers, developers).

Search and read:

"What does our wiki say about deployment?"
"Give me a quick overview of the Configuration page"
"Get the content of Main Page, FAQ, and Setup all at once"

Track changes:

"What pages were updated this week?"
"Show me the diff between the last two versions"
"Who are the most active editors this month?"

Check quality:

"Are there broken links on this page?"
"Find orphaned pages with no links to them"
"Find pages similar to the Installation Guide"
"Find pages not updated in the last 90 days"

Page management (requires auth):

"Rename 'Old Guide' to 'Updated Guide'"
"Strike out John Smith on the Team page"
"Replace 'version 2.0' with 'version 3.0' on Release Notes"

File uploads and search (requires auth):

"Upload this image from URL to the wiki"
"Upload this local file to the wiki" (the agent base64-encodes the bytes; no public URL needed)
"Search for 'budget' in File:Annual-Report.pdf"

Convert Markdown:

"Convert this README to wiki format"
"Convert with Tieto branding and CSS" (use theme="tieto", add_css=true)

PDF Search Setup

PDF search requires the pdftotext tool from poppler-utils. Text file search (TXT, MD, CSV, etc.) works without any dependencies.

Platform	Install Command
macOS	`brew install poppler`
Ubuntu/Debian	`apt install poppler-utils`
RHEL/CentOS	`yum install poppler-utils`
Windows	`choco install poppler`

Windows alternative: Download binaries from poppler-windows releases and add to PATH.

Verify installation:

bash

pdftotext -v

Compatibility

Platform	Transport	Status
Claude Desktop (Mac/Windows)	stdio	✅ Supported
Claude Code CLI	stdio	✅ Supported
Cursor	stdio	✅ Supported
VS Code	stdio	✅ Supported
ChatGPT	HTTP	✅ Supported
n8n	HTTP	✅ Supported
Google ADK	stdio / HTTP	✅ Supported

Works with any wiki: Wikipedia, Fandom, corporate wikis, or any MediaWiki installation.

Troubleshooting

Common issues and fixes live in SETUP.md#troubleshooting. For deeper diagnostics, the HTTP server exposes /health, /ready, and /status endpoints — see DEPLOYMENT.md.

Development

Build, test, and contribute: see CONTRIBUTING.md. For the system design, package layout, and data flow, see ARCHITECTURE.md.

Run the full check before pushing:

bash

go test -race -failfast ./...
golangci-lint run ./...

Integration tests run against a real MediaWiki instance via docker-compose.test.yml. See CONTRIBUTING.md for the workflow.

Like This Project?

If this server saved you time, consider giving it a ⭐ on GitHub. It helps others discover the project.

More MCP Servers

Check out my other MCP servers:

Server	Description	Stars
gleif-mcp-server	Access GLEIF LEI database. Look up company identities, verify legal entities.
miro-mcp-server	Control Miro whiteboards with AI. Boards, diagrams, mindmaps, and more.
nordic-registry-mcp-server	Access Nordic business registries. Look up companies across Norway, Denmark, Finland, Sweden.
productplan-mcp-server	Talk to your ProductPlan roadmaps. Query OKRs, ideas, launches.
tilbudstrolden-mcp	Nordic grocery deal hunting. Find offers, plan meals, track spending.
mcp-servercard-go	Go library for SEP-2127 Server Cards. Pre-connect discovery for MCP servers.

License

MIT License

Credits

Built with Go MCP SDK
Powered by MediaWiki API

Install

Configuration

Environment variables

MEDIAWIKI_URLrequired

MediaWiki API endpoint URL (e.g., https://en.wikipedia.org/w/api.php)

MEDIAWIKI_USERNAME

Bot username for authenticated operations (format: WikiUser@BotName)

MEDIAWIKI_PASSWORDsecret

Bot password for authenticated operations

claude_desktop_config.json

{
  "mcpServers": {
    "mediawiki-mcp-server": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/olgasafonova/mediawiki-mcp-server:1.32.1"
      ],
      "env": {
        "MEDIAWIKI_URL": "<YOUR_MEDIAWIKI_URL>",
        "MEDIAWIKI_USERNAME": "<YOUR_MEDIAWIKI_USERNAME>",
        "MEDIAWIKI_PASSWORD": "<YOUR_MEDIAWIKI_PASSWORD>"
      }
    }
  }
}