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