README - MediaWiki-MCP-Server by professionalwiki

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

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

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

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

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:

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.
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 file for details.