@gesslar/mediawiki-mcp

A Model Context Protocol server that lets MCP-compatible clients create, edit, delete, read, and search articles on a MediaWiki instance.

Requirements

• Node.js >=24.11.0
• A MediaWiki instance with API access
• A bot account with sufficient permissions for the operations you intend to perform

Installation

npm install -g @gesslar/mediawiki-mcp

Or run it directly via npx:

npx @gesslar/mediawiki-mcp

Configuration

The server is configured through environment variables:

| Variable | Description | | --- | --- | | MEDIAWIKI_URL | Base URL of the MediaWiki instance (e.g. https://wiki.example.com) | | MEDIAWIKI_BOT_USERNAME | Bot account username | | MEDIAWIKI_BOT_PASSWORD | Bot account password |

All three variables are required. The server will exit on startup if any are missing.

Note: The server currently authenticates all reads and writes (private: true on the underlying Wikid client). This is intentional for wikis that require authentication for read access. If you're pointing this at a fully public wiki, reads will still work — they'll just be authenticated when they wouldn't strictly need to be. This package is released under 0BSD, so if the hardcoded behaviour doesn't suit your setup, you're welcome to fork it and tweak the Wikid constructor options to taste.

Usage with an MCP client

Add the server to your MCP client configuration. For example, in a Claude Desktop claude_desktop_config.json:

{
  "mcpServers": {
    "mediawiki": {
      "command": "npx",
      "args": ["-y", "@gesslar/mediawiki-mcp"],
      "env": {
        "MEDIAWIKI_URL": "https://wiki.example.com",
        "MEDIAWIKI_BOT_USERNAME": "YourBot@YourBotPassword",
        "MEDIAWIKI_BOT_PASSWORD": "your-bot-password"
      }
    }
  }
}

The server communicates over stdio.

Tools

The server exposes the following tools:

mediawiki_create_article

Create a new article. Fails if the article already exists.

| Parameter | Type | Required | Description | | --- | --- | --- | --- | | title | string | yes | Title of the article to create | | content | string | yes | Wikitext content for the article | | summary | string | no | Edit summary |

mediawiki_edit_article

Edit an existing article. Supports full replacement, append, or prepend.

| Parameter | Type | Required | Description | | --- | --- | --- | --- | | title | string | yes | Title of the article to edit | | content | string | yes | New wikitext content | | summary | string | no | Edit summary | | append | boolean | no | Append content instead of replacing | | prepend | boolean | no | Prepend content instead of replacing |

mediawiki_delete_article

Delete an article. Requires delete permissions on the bot account.

| Parameter | Type | Required | Description | | --- | --- | --- | --- | | title | string | yes | Title of the article to delete | | reason | string | no | Reason for deletion |

mediawiki_get_article

Return the current wikitext content of an article.

| Parameter | Type | Required | Description | | --- | --- | --- | --- | | title | string | yes | Title of the article to retrieve |

mediawiki_search

Search articles on the wiki.

| Parameter | Type | Required | Description | | --- | --- | --- | --- | | query | string | yes | Search query | | limit | number | no | Maximum number of results (default: 10) |

Development

# Start the server locally
npm start

# Lint
npm run lint
npm run lint:fix

License

@gesslar/mediawiki-mcp is released under the 0BSD.

This package includes or depends on third-party components under their own licenses:

| Dependency | License | | --- | --- | | @gesslar/wikid | 0BSD | | @modelcontextprotocol/sdk | MIT | | zod | MIT |