mcp-mediawiki-crunchtools
Secure MCP server for MediaWiki wikis. Search, read, create, edit, and manage wiki pages, categories, files, and more. Works with any MediaWiki instance — public or private.
Installation
uvx (recommended)
uvx mcp-mediawiki-crunchtools
pip
pip install mcp-mediawiki-crunchtools
mcp-mediawiki-crunchtools
Container
podman run -e MEDIAWIKI_URL=https://en.wikipedia.org/w/ \
quay.io/crunchtools/mcp-mediawiki
Usage with Claude Code
Read-only (public wiki, no auth needed)
claude mcp add mcp-mediawiki-crunchtools \
--env MEDIAWIKI_URL=https://en.wikipedia.org/w/ \
-- uvx mcp-mediawiki-crunchtools
With authentication (for write operations)
claude mcp add mcp-mediawiki-crunchtools \
--env MEDIAWIKI_URL=https://your-wiki.com/w/ \
--env MEDIAWIKI_USERNAME=BotUser \
--env MEDIAWIKI_PASSWORD=BotPassword \
-- uvx mcp-mediawiki-crunchtools
HTTP transport (systemd / container)
podman run -d --name mcp-mediawiki \
-p 127.0.0.1:8016:8016 \
-e MEDIAWIKI_URL=https://your-wiki.com/w/ \
quay.io/crunchtools/mcp-mediawiki \
--transport streamable-http --host 0.0.0.0
Claude Code config:
{"type": "http", "url": "http://127.0.0.1:8016/mcp"}
Environment Variables
| Variable | Required | Description |
|---|---|---|
MEDIAWIKI_URL | Yes | Wiki base URL (e.g., https://en.wikipedia.org/w/) |
MEDIAWIKI_USERNAME | No | Bot/user account for write operations |
MEDIAWIKI_PASSWORD | No | Bot/user password |
MEDIAWIKI_HTTP_USER | No | HTTP Basic Auth username (.htaccess) |
MEDIAWIKI_HTTP_PASS | No | HTTP Basic Auth password |
Tools (19)
| Category | Tool | Description |
|---|---|---|
| Pages | search | Full-text search across wiki |
| Pages | get_page | Get page wikitext content |
| Pages | get_page_html | Parse page to HTML |
| Pages | list_pages | List pages with prefix filter |
| Pages | create_page | Create a new page |
| Pages | edit_page | Edit an existing page |
| Pages | delete_page | Delete a page |
| Pages | move_page | Move/rename a page |
| Categories | list_categories | List all categories |
| Categories | get_category_members | Get pages in a category |
| Categories | get_page_categories | Get categories for a page |
| Recent Changes | list_recent_changes | List recent edits |
| Parsing | parse_wikitext | Parse raw wikitext to HTML |
| Site Info | get_site_info | Get wiki config and version |
| Site Info | list_namespaces | List wiki namespaces |
| Users | get_user_info | Get user details |
| Users | list_user_contributions | List user edits |
| Files | get_file_info | Get file/image metadata |
| Files | list_files | List files on the wiki |
Development
# Install dev dependencies
uv sync --all-extras
# Quality gates
uv run ruff check src tests
uv run mypy src
uv run pytest -v
gourmand --full .
podman build -f Containerfile .
License
AGPL-3.0-or-later