mediawiki

This MCP server provides an interface to interact with Wikipedia via the MediaWiki REST API. It exposes a set of tools to search for wiki pages and retrieve detailed page content, allowing language models or clients to request concise results or full page data. The server supports multiple transports for communication: stdio by default, streamable-http, and server-sent events (SSE). You can switch transport modes with the available flags (for example, --http for streamable-http or --sse for SSE) and configure the base API URL to point at the wiki site you want to query.

To use it, configure the base URL of the target wiki (default is https://en.wikipedia.org/). You can change the target site by supplying a base URL argument, for example --base-url https://en.wikipedia.org/w/rest.php/v1/page. Once running, you can query the server to search for pages or fetch page content using the provided tools. The known tools include a search capability (query) to find pages by keyword and a get page capability (title) to retrieve the full content of a page. The server exposes endpoints compatible with MCP tooling, making it straightforward to integrate into your LLM workflows or other automation.

Documentation and examples in the README show how to invoke the server and the supported options, such as testing a base URL, enabling different transport modes, and performing common operations like searching and getting page content.

Prerequisites:

• Python 3.13 or later installed on your system
• Internet access to fetch dependencies
• Optional: git if you plan to clone from source or adjust the repository

Install from prebuilt release using uv/uvx (recommended):

1. Ensure Python and pip are installed on your system.
2. Install the uvx runtime (the MCP runner for Python-based servers).
   • Example (via pipx):

     pipx install uvx
     

3. Install the MediaWiki MCP Server package or clone the repository if you need to run from source.
4. Run the server using uvx with the provided arguments, for example:

   uvx mediawiki-mcp-server --base-url https://en.wikipedia.org/
   

Install from source (if you prefer to run directly from the project code):

1. Clone the repository:

   git clone https://github.com/shiquda/mediawiki-mcp-server.git
   cd mediawiki-mcp-server
   

2. Install dependencies (if any are listed in requirements.txt or pyproject.toml):

   python -m pip install --upgrade pip
   python -m pip install -r requirements.txt  # if present
   

3. Run the server from the project directory:

   uv run mediawiki-mcp-server --base-url https://en.wikipedia.org/
   

Notes:

• If you use a proxy, set the HTTP_PROXY environment variable as shown in the examples.
• The default base URL points to Wikipedia; you can point it at other MediaWiki-based sites by changing --base-url.

Tips and notes:

• The server exposes multiple transports. Use --http for streaming via HTTP, or --sse to enable Server-Sent Events. The default is stdio, which is useful for local testing.
• When testing against different MediaWiki installations, ensure the base URL ends with the appropriate path for the REST API (commonly /rest.php/v1/page for page data). If a site requires adjustments, experiment with the --base-url flag to find a compatible endpoint.
• If you encounter issues related to proxies, set HTTP_PROXY (and possibly HTTPS_PROXY) environment variables to route traffic through your proxy.
• For development, you can run from source to customize behavior; follow the installation steps for running from source above. The README also provides example configurations in JSON format that you can reuse in your MCP setup.
• The server is intended to be combined with MCP tooling for prompts, tooling integration, and orchestration with other MCP-enabled services.