Skip to content

ProfessionalWiki/MediaWiki-MCP-Server

Repository files navigation

MediaWiki MCP Server

smithery badge

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: Request from the Special:OAuthConsumerRegistration/propose/oauth2 page on the wiki.

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
WIKI_SERVER Domain of the wiki (e.g. https://en.wikipedia.org) 'https://en.wikipedia.org'
ARTICLE_PATH Article path of the wiki (e.g. /wiki) '/wiki'
SCRIPT_PATH Script path of the wiki (e.g. /w) '/w'
OAUTH_TOKEN OAuth token obtained via Special:OAuthConsumerRegistration/propose/oauth2 provided by the OAuth extension. Select "This consumer is for use only by UserName" undefined

Installation

Install via Smithery

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

npx -y @smithery/cli install @ProfessionalWiki/mediawiki-mcp-server --client claude
Install in Claude Desktop

Follow the guide, use following configuration:

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

Install in VS Code Install in VS Code Insiders

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

Install in Cursor

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"
      ]
    }
  }
}
Install in Windsurf

Follow the guide, use following configuration:

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

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).

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.