MediaWiki

What is MediaWiki-MCP-Server?

MediaWiki-MCP-Server is an MCP (Model Context Protocol) server designed to enable Large Language Model (LLM) clients to interact seamlessly with any MediaWiki wiki. It acts as a bridge, allowing LLMs to perform various operations on a wiki, such as creating, retrieving, and updating pages.

How to use MediaWiki-MCP-Server?

MediaWiki-MCP-Server can be installed and used with various MCP clients. Installation methods include:

• Install via Smithery: Use the npx -y @smithery/cli install @ProfessionalWiki/mediawiki-mcp-server --client claude command.
• Install in Claude Desktop, VS Code, Cursor, Windsurf, or Claude Code: These clients provide specific configuration instructions, typically involving adding a JSON configuration snippet to their respective settings files. The configuration usually specifies the command to run the server, for example, npx @professional-wiki/mediawiki-mcp-server@latest.

For development, you can use npm run dev to start the development server and MCP Inspector, or npm run watch to compile source changes and test with MCP clients.

Key Features of MediaWiki-MCP-Server

MediaWiki-MCP-Server offers a set of tools for interacting with MediaWiki wikis:

• create-page (🔐 Requires OAuth 2.0 token): Create a new wiki page.
• get-file: Returns the standard file object for a file page.
• get-page: Returns the standard page object for a wiki page.
• get-page-history: Returns information about the latest revisions to a wiki page.
• search-page: Search wiki page titles and contents for provided search terms.
• set-wiki: Set the wiki to use for the current session.
• update-page (🔐 Requires OAuth 2.0 token): Update an existing wiki page.

It also supports environment variables for configuration, such as CONFIG (path to configuration file), MCP_TRANSPORT (type of MCP server transport), and PORT (port for StreamableHTTP transport).

Use Cases of MediaWiki-MCP-Server

• Automated Wiki Content Management: LLMs can be used to automatically create, update, and manage content on MediaWiki sites, such as generating new articles, updating existing information, or correcting errors.
• Intelligent Information Retrieval: LLM clients can leverage the search-page and get-page tools to intelligently retrieve specific information from a MediaWiki wiki based on user queries.
• LLM-powered Wiki Bots: Develop bots that can interact with MediaWiki, performing tasks like responding to queries, summarizing content, or moderating discussions.
• Integration with AI Development Environments: Seamlessly integrate MediaWiki data and functionalities into AI development workflows within platforms like VS Code, Claude Desktop, and Cursor.

FAQ about MediaWiki-MCP-Server

• What is an MCP server? An MCP (Model Context Protocol) server enables Large Language Model (LLM) clients to interact with external systems, in this case, a MediaWiki wiki.
• Do I need an OAuth 2.0 token? Yes, for create-page and update-page tools, an OAuth 2.0 token is required. This token is obtained via Special:OAuthConsumerRegistration/propose/oauth2 provided by the MediaWiki OAuth extension.
• How can I develop with MediaWiki-MCP-Server? You can use Docker for development (make dev) or utilize the MCP Inspector by running npm run dev. For testing with MCP clients, run npm run watch.
• What are the supported installation methods? MediaWiki-MCP-Server can be installed via Smithery, or configured directly within various MCP clients like Claude Desktop, VS Code, Cursor, Windsurf, and Claude Code.
• Where can I find the license information? The project is licensed under the GPL 2.0 License, and details can be found in the LICENSE file.

MediaWiki MCP Server

An MCP (Model Context Protocol) server that enables Large Language Model (LLM) clients to interact with any MediaWiki wiki.

Feature

Tools

🔐 Requires OAuth 2.0 token in configuration: Obtained via Special:OAuthConsumerRegistration/propose/oauth2 provided by the OAuth extension. Select "This consumer is for use only by UserName"

Name	Description
create-page 🔐	Create a new wiki page.
get-file	Returns the standard file object for a file page.
get-page	Returns the standard page object for a wiki page.
get-page-history	Returns information about the latest revisions to a wiki page.
search-page	Search wiki page titles and contents for the provided search terms.
set-wiki	Set the wiki to use for the current session.
update-page 🔐	Update an existing wiki page.

Environment variables

Name	Description	Default
CONFIG	Path to your configuration file	config.json
MCP_TRANSPORT	Type of MCP server transport (stdio or http)	stdio
PORT	Port used for StreamableHTTP transport	3000

Installation

To install MediaWiki MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @ProfessionalWiki/mediawiki-mcp-server --client claude

Follow the guide, use following configuration:

{
  "mcpServers": {
    "mediawiki-mcp-server": {
      "command": "npx",
      "args": [
        "@professional-wiki/mediawiki-mcp-server@latest"
      ]
    }
  }
}

code --add-mcp '{"name":"mediawiki-mcp-server","command":"npx","args":["@professional-wiki/mediawiki-mcp-server@latest"]}'

Go to Cursor Settings -> MCP -> Add new MCP Server. Name to your liking, use command type with the command npx @professional-wiki/mediawiki-mcp-server. You can also verify config or add command like arguments via clicking Edit.

{
  "mcpServers": {
    "mediawiki-mcp-server": {
      "command": "npx",
      "args": [
        "@professional-wiki/mediawiki-mcp-server@latest"
      ]
    }
  }
}

Follow the guide, use following configuration:

{
  "mcpServers": {
    "mediawiki-mcp-server": {
      "command": "npx",
      "args": [
        "@professional-wiki/mediawiki-mcp-server@latest"
      ]
    }
  }
}

Follow the Claude Code MCP docs.

Run the below command, optionally with -e flags to specify environment variables.

claude mcp add mediawiki-mcp-server npx @professional-wiki/mediawiki-mcp-server@latest

You should end up with something like the below in your .claude.json config:

"mcpServers": {
  "mediawiki-mcp-server": {
    "type": "stdio",
    "command": "npx",
    "args": [
      "@professional-wiki/mediawiki-mcp-server@latest"
    ],
    "env": {
      "WIKI_SERVER": "your.example.wiki",
      "OAUTH_TOKEN": ""
    }
  }
},

Development

🐋 Develop with Docker: Replace the npm run part of the command with make (e.g. make dev).

MCP Inspector

To start the development server and the MCP Inspector:

npm run dev

The command will build and start the MCP Proxy server locally at 6277 and the MCP Inspector client UI at http://localhost:6274.

Test with MCP clients

To enable your MCP client to use this MediaWiki MCP Server for local development:

1. Register the MCP server in your client config (e.g. claude_desktop_config.json for Claude Desktop). An example config is provided at mcp.json.

2. Run the watch command so that the source will be compiled whenever there is a change:

   npm run watch
   

Contributing

Contributions are welcome! Please feel free to submit a pull request or open an issue for bugs, feature requests, or suggestions.

License

This project is licensed under the GPL 2.0 License. See the LICENSE file for details.