Skip to main content

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

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

mcp_mediawiki_crunchtools-0.1.3.tar.gz (41.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

mcp_mediawiki_crunchtools-0.1.3-py3-none-any.whl (32.5 kB view details)

Uploaded Python 3

File details

Details for the file mcp_mediawiki_crunchtools-0.1.3.tar.gz.

File metadata

File hashes

Hashes for mcp_mediawiki_crunchtools-0.1.3.tar.gz
Algorithm Hash digest
SHA256 9688bfa2ea6ed2cbd88a16c925d1dc4bc5ef560481279c8173455ad1ef0898d2
MD5 fa89eb5532a5a1c855b6d80c1dd8cb7d
BLAKE2b-256 757e49ae8d8d5df817d752c4232a001eefbaa10f3044cf56ef2b3fd9b5de191b

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_mediawiki_crunchtools-0.1.3.tar.gz:

Publisher: publish.yml on crunchtools/mcp-mediawiki

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file mcp_mediawiki_crunchtools-0.1.3-py3-none-any.whl.

File metadata

File hashes

Hashes for mcp_mediawiki_crunchtools-0.1.3-py3-none-any.whl
Algorithm Hash digest
SHA256 5f09f62ac7fafa3f42ba3644767ffdf0f040a88d22362b3c1d45355d6b02b68b
MD5 24893b901f78d94fd4116bd3696501a2
BLAKE2b-256 dba73b3fea8cf1348fabb4e0ecec877b606fb299ef5c5bcc23f9cc93f599569e

See more details on using hashes here.

Provenance

The following attestation bundles were made for mcp_mediawiki_crunchtools-0.1.3-py3-none-any.whl:

Publisher: publish.yml on crunchtools/mcp-mediawiki

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Release history Release notifications | RSS feed

This release

0.1.3 This release

2 files

0.1.2

2 files

0.1.0

2 files

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page