Back to Directory/Search & Knowledge

MCP Mediawiki

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

Search & KnowledgePythonv0.1.2

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

VariableRequiredDescription
MEDIAWIKI_URLYesWiki base URL (e.g., https://en.wikipedia.org/w/)
MEDIAWIKI_USERNAMENoBot/user account for write operations
MEDIAWIKI_PASSWORDNoBot/user password
MEDIAWIKI_HTTP_USERNoHTTP Basic Auth username (.htaccess)
MEDIAWIKI_HTTP_PASSNoHTTP Basic Auth password

Tools (19)

CategoryToolDescription
PagessearchFull-text search across wiki
Pagesget_pageGet page wikitext content
Pagesget_page_htmlParse page to HTML
Pageslist_pagesList pages with prefix filter
Pagescreate_pageCreate a new page
Pagesedit_pageEdit an existing page
Pagesdelete_pageDelete a page
Pagesmove_pageMove/rename a page
Categorieslist_categoriesList all categories
Categoriesget_category_membersGet pages in a category
Categoriesget_page_categoriesGet categories for a page
Recent Changeslist_recent_changesList recent edits
Parsingparse_wikitextParse raw wikitext to HTML
Site Infoget_site_infoGet wiki config and version
Site Infolist_namespacesList wiki namespaces
Usersget_user_infoGet user details
Userslist_user_contributionsList user edits
Filesget_file_infoGet file/image metadata
Fileslist_filesList 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

Installation

Source-derived launch command. Check the maintainer’s required arguments and credentials before running:

bash
uvx mcp-mediawiki-crunchtools

Set up in your AI client

Merge this template into ~/Library/Application Support/Claude/claude_desktop_config.json. Keep existing servers. Add any arguments, credentials, and permissions required by the maintainer; this template has not been install-tested.

json
{
  "mcpServers": {
    "io-github-crunchtools-mediawiki": {
      "command": "uvx",
      "args": [
        "mcp-mediawiki-crunchtools"
      ]
    }
  }
}

Restart Claude Desktop completely for changes to take effect. Confirm the server appears connected in the client’s tool list, then try a read-only example from its documentation.

Claude Desktop setup reference

Package

mcp-mediawiki-crunchtoolspypi

Compatible MCP Clients

MCP Mediawiki works with any MCP-compatible client. Copy the config snippet from the Configuration section above and add it to the file shown for your client, then restart the application.

  • Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.jsonRestart Claude Desktop completely for changes to take effect.
  • Cursor~/.cursor/mcp.jsonRestart Cursor for changes to take effect.
  • VS Code.vscode/mcp.jsonReload VS Code window for changes to take effect.
  • Windsurf~/.codeium/windsurf/mcp_config.jsonRestart Windsurf for changes to take effect.
  • Claude Code.mcp.jsonSave at the project root, then start Claude Code in that project and review the MCP server approval prompt. Keep real credentials out of shared files.

Learn More