MediaWiki

Connect your AI assistant directly to a MediaWiki installation to search, read, and edit wiki content using natural language. This MCP server lets your AI agents interact with MediaWiki as a first-class data source, enabling fast queries, page edits, and content analysis through familiar MCP clients.

How to use

You connect the MCP server to your MediaWiki instance and then interact with it through your preferred MCP client. Common tasks include searching for topics, retrieving page content and structure, checking for broken links, and making edits with proper authentication. Start by configuring the server with your wiki’s API URL, then connect your MCP client to the server. Once connected, you can ask questions like, “What does our wiki say about onboarding?” or “Find all pages mentioning the API” and the server will perform the requested actions against your wiki.

How to install

Prerequisites: you need a working Go toolchain if you plan to build from source, and you should have an MCP client ready to connect to the server. Follow these concrete steps to get up and running.

# Option A: Download pre-built binary (easiest)
# Go to the releases page and download for your platform

# Option B: Build from source (Go 1.24+ required)

git clone https://github.com/olgasafonova/mediawiki-mcp-server.git
cd mediawiki-mcp-server
go build -o mediawiki-mcp-server .

Additional configuration and start options

You can run the server in HTTP mode for remote access or in stdio mode for local usage with MCP clients installed on the same machine. The wiki API URL must be provided to the server, and you can protect HTTP access with a bearer token and restrict which origins can talk to the server.

Example run in HTTP mode (server exposed at port 8080):

# Set your wiki URL
export MEDIAWIKI_URL="https://your-wiki.com/api.php"

# Generate a secure token
export MCP_AUTH_TOKEN=$(openssl rand -hex 32)
echo "Save this token: $MCP_AUTH_TOKEN"

# Start the server
./mediawiki-mcp-server -http :8080

Security and authentication

When exposing the server over HTTP, always enable authentication and consider HTTPS behind a reverse proxy. Use a strong bearer token and limit allowed origins to only the domains you control. Private or corporate wikis often require authentication for all operations, including reading.

Environment variables at a glance

Key environment variables you will see in configuration snippets and usage notes include the wiki API URL and optional credentials.

Troubleshooting tips

If you encounter issues, verify that MEDIAWIKI_URL is correct, ensure your bot credentials (if editing) are valid, and confirm the server is reachable from the MCP client. Check that the HTTP server is publicly accessible if your client is external, and verify that the token used matches the one configured on the server.

Example prompts to try

Try prompts like “Search the wiki for getting started,” “Show me the sections of the Installation Guide,” or “Find pages related to the API Reference.” These prompts leverage the server’s read and discovery tools to return relevant wiki content.

PDF and file handling notes

If you need to search within PDFs, install the required PDF text extraction tool on your system. For other text formats (TXT, MD, CSV, etc.), standard text search works out of the box.

Available tools

mediawiki_search

Full-text search across wiki content.

mediawiki_get_page

Retrieve the content of a specific page.

mediawiki_get_sections

Fetch the structure of a page or a specific section.

mediawiki_get_related

Find related pages via categories or links.

mediawiki_get_images

List images used on a page.

mediawiki_list_pages

List all pages in the wiki.

mediawiki_get_page_info

Get metadata for a page.

mediawiki_get_wiki_info

Gather wiki-wide statistics.

mediawiki_edit_page

Create or edit a wiki page.

mediawiki_upload_file

Upload a file to the wiki.

mediawiki_check_links

Check whether external links work.

mediawiki_find_broken_internal_links

Identify broken internal links.

mediawiki_find_similar_pages

Find pages with similar content.

mediawiki_audit

Run a comprehensive health audit of wiki content.

mediawiki_get_revisions

Fetch page edit histories.

mediawiki_get_revisions

Diffs between revisions.

mediawiki_get_recent_changes

Recent wiki activity with aggregation.

mediawiki_convert_markdown

Convert Markdown to MediaWiki markup.

mediawiki_convert_markdown

Apply theme and styling options for publication.

mediawiki_find_replace

Find and replace text across pages.

mediawiki_apply_formatting

Apply bold, italic, or strikethrough formatting.

mediawiki_search_in_file

Search text within files like PDFs or text docs.

mediawiki_get_backlinks

Show pages that link to a given page.

mediawiki_parse

Preview wikitext syntax.