Skip to main content

Secure MCP server for MediaWiki wikis — search, pages, categories, and more

Project description

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

Project details


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.

Supported by

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