MediaWiki

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.

[CI] [lint] [CodeScene Average Code Health] [License: MIT]

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