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
Metadata
Release files for mcp-mediawiki-crunchtools 0.1.4
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| mcp_mediawiki_crunchtools-0.1.4.tar.gz | 153.6 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| mcp_mediawiki_crunchtools-0.1.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 186.2 kB
Release files / mcp_mediawiki_crunchtools-0.1.4.tar.gz
| Download URL | mcp_mediawiki_crunchtools-0.1.4.tar.gz |
|---|---|
| Size | 153.6 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
95afe8c28ed5aae2cd09e55e6f0f5e1680d1bfc809ca060ea21c53b764353270
|
|
BLAKE2b-256 checksum How to use checksums |
a0417758920f8e63013e92267e95210192cf0f79f2a5b2715354bc8ac51fc55e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.
Transparency logRelease files / mcp_mediawiki_crunchtools-0.1.4-py3-none-any.whl
| Download URL | mcp_mediawiki_crunchtools-0.1.4-py3-none-any.whl |
|---|---|
| Size | 32.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
a24e0ba9be477339b3bd3f7e73e575b2ef6c2649a966b039f6cdc679bea27b8c
|
|
BLAKE2b-256 checksum How to use checksums |
4af09024e94d4ca6741abae87371f4dda4267f427e0afbd50b7c370807e70d97
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 1, 2026.
Transparency log