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:

1. MCP server — Claude Desktop, Claude Code, Cursor, ChatGPT, n8n, VS Code, Google ADK, or any MCP-compatible tool. See SETUP.md.

2. `wiki` CLI — same API client, same auth, no AI needed. For shell pipelines, CI checks, cron jobs. See CLI.md.

3. Claude Code plugin — `/plugin marketplace add olgasafonova/mediawiki-mcp-server` adds wiki skills directly to Claude Code. See .claude-plugin/README.md.

Documentation

What Can You Do?

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

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

30-Second Start

1. Get the binary. Download from Releases or `go build -o mediawiki-mcp-server .` (requires Go 1.24+).

2. 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.

3. 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.

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

Verify installation:

pdftotext -v

Compatibility

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:

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:

License

MIT License

Credits

• Built with Go MCP SDK
• Powered by MediaWiki API