olgasafonova/mediawiki-mcp-server

MediaWiki MCP Server

Connect your AI assistant to any MediaWiki wiki. Search, read, and edit wiki content using natural language.

Works with: Claude Desktop, Claude Code, Cursor, ChatGPT, n8n, and any MCP-compatible tool.

What Can You Do?

Once connected, just ask your AI:

Get Started

Step 1: Download

Option A: Download pre-built binary (easiest)

Go to Releases and download for your platform.

Option B: Build from source (requires Go 1.23+)

git clone https://github.com/olgasafonova/mediawiki-mcp-server.git
cd mediawiki-mcp-server
go build -o mediawiki-mcp-server .

Step 2: Find Your Wiki's API URL

Your wiki's API URL is usually:

Tip: Visit Special:Version on your wiki to find the exact API endpoint.

Step 3: Configure Your AI Tool

Pick your tool:

Claude Desktop

Works on Mac and Windows. No terminal needed after initial setup.

Claude Code CLI

The fastest setup. One command and you're done.

claude mcp add mediawiki /path/to/mediawiki-mcp-server \
  -e MEDIAWIKI_URL="https://your-wiki.com/api.php"

Test it: Ask "Search the wiki for getting started"

Cursor

ChatGPT

ChatGPT connects via HTTP. You need to run the server on a machine ChatGPT can reach.

Requirements: ChatGPT Pro, Plus, Business, Enterprise, or Education account.

Setup

1. Start the server with HTTP mode:

   # Set your wiki URL
   export MEDIAWIKI_URL="https://your-wiki.com/api.php"
   
   # Generate a secure token
   export MCP_AUTH_TOKEN=$(openssl rand -hex 32)
   echo "Save this token: $MCP_AUTH_TOKEN"
   
   # Start the server
   ./mediawiki-mcp-server -http :8080
   

2. In ChatGPT:

   • Go to Settings → Connectors → Advanced → Developer Mode
   • Add a new MCP connector
   • URL: http://your-server:8080 (must be publicly accessible)
   • Authentication: Bearer token → paste your token

3. Test it: Ask "Search the wiki for getting started"

For production: See Security Best Practices for HTTPS setup.

n8n

n8n connects via HTTP using the MCP Client Tool node.

Setup

1. Start the server with HTTP mode:

   export MEDIAWIKI_URL="https://your-wiki.com/api.php"
   export MCP_AUTH_TOKEN="your-secure-token"
   ./mediawiki-mcp-server -http :8080
   

2. In n8n:

   • Add an MCP Client Tool node
   • Transport: HTTP Streamable
   • URL: http://your-server:8080
   • Authentication: Bearer → your token

3. Enable for AI agents (add to n8n environment):

   N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true
   

4. Connect the MCP Client Tool to an AI Agent node.

VS Code

Install the Cline extension, then configure it the same way as Cursor.

Google ADK

Google's Agent Development Kit connects to MCP servers via stdio or Streamable HTTP.

import (
    "os/exec"
    "google.golang.org/adk/tool/mcptoolset"
    "github.com/modelcontextprotocol/go-sdk/mcp"
)

// Create MCP toolset for wiki access
wikiTools, _ := mcptoolset.New(mcptoolset.Config{
    Transport: &mcp.CommandTransport{
        Command: exec.Command("/path/to/mediawiki-mcp-server"),
        Env: []string{
            "MEDIAWIKI_URL=https://your-wiki.com/api.php",
        },
    },
})

// Add to your agent
agent := llmagent.New(llmagent.Config{
    Name:     "wiki-agent",
    Model:    model,
    Toolsets: []tool.Set{wikiTools},
})

export MEDIAWIKI_URL="https://your-wiki.com/api.php"
./mediawiki-mcp-server -http :8080 -token "your-secret-token"

import (
    "google.golang.org/adk/tool/mcptoolset"
    "github.com/modelcontextprotocol/go-sdk/mcp"
)

wikiTools, _ := mcptoolset.New(mcptoolset.Config{
    Transport: mcp.NewStreamableHTTPClientTransport("http://localhost:8080"),
})

from google.adk.tools.mcp_tool import MCPToolset, StdioConnectionParams, StdioServerParameters

wiki_tools = MCPToolset(
    connection_params=StdioConnectionParams(
        server_params=StdioServerParameters(
            command="/path/to/mediawiki-mcp-server",
            env={"MEDIAWIKI_URL": "https://your-wiki.com/api.php"},
        )
    )
)

from google.adk.tools.mcp_tool import MCPToolset, StreamableHTTPConnectionParams

wiki_tools = MCPToolset(
    connection_params=StreamableHTTPConnectionParams(
        url="http://localhost:8080",
        headers={"Authorization": "Bearer your-secret-token"},
    )
)

Need to Edit Wiki Pages?

Reading works without login. Editing requires a bot password.

Create a Bot Password

1. Log in to your wiki
2. Go to Special:BotPasswords (e.g., https://your-wiki.com/wiki/Special:BotPasswords)
3. Enter a bot name: mcp-assistant
4. Check these permissions:
   • ✅ Basic rights
   • ✅ Edit existing pages
5. Click Create and save the password (you won't see it again)

Add Credentials to Your Config

Claude Desktop / Cursor:

{
  "mcpServers": {
    "mediawiki": {
      "command": "/path/to/mediawiki-mcp-server",
      "env": {
        "MEDIAWIKI_URL": "https://your-wiki.com/api.php",
        "MEDIAWIKI_USERNAME": "YourWikiUsername@mcp-assistant",
        "MEDIAWIKI_PASSWORD": "your-bot-password-here"
      }
    }
  }
}

Claude Code CLI:

claude mcp add mediawiki /path/to/mediawiki-mcp-server \
  -e MEDIAWIKI_URL="https://your-wiki.com/api.php" \
  -e MEDIAWIKI_USERNAME="YourWikiUsername@mcp-assistant" \
  -e MEDIAWIKI_PASSWORD="your-bot-password-here"

Example Prompts

📖 More examples: See for detailed workflows by persona (content editors, documentation managers, developers).

Search & Read

• "What does our wiki say about deployment?"
• "Find all pages mentioning the API"
• "Show me the Getting Started guide"
• "List all pages in the Documentation category"

Sections & Related Content ✨

• "Show me the sections of the Installation Guide"
• "Get the 'Troubleshooting' section from the FAQ page"
• "Find pages related to the API Reference"
• "What images are on the Product Overview page?"

Track Changes

• "What pages were updated this week?"
• "Who edited the Release Notes page?"
• "Show me the diff between the last two versions"
• "Who are the most active editors this month?" ✨
• "Which pages get edited most frequently?" ✨

Check Quality

• "Are there broken links on this page?"
• "Find orphaned pages with no links to them"
• "Check terminology consistency in the Product category"
• "Find pages similar to the Installation Guide" ✨
• "Compare how 'API version' is documented across pages" ✨

Quick Edits (requires auth)

• "Strike out John Smith on the Team page"
• "Replace 'version 2.0' with 'version 3.0' on Release Notes"
• "Make 'API Gateway' bold on the Architecture page"

File Uploads (requires auth) ✨

• "Upload this image from URL to the wiki"
• "Add the logo from https://example.com/logo.png as Company_Logo.png"

File Search ✨

• "Search for 'budget' in File:Annual-Report.pdf"
• "Find mentions of 'API' in the changelog.txt file"

Note: PDF search requires poppler-utils installed. See PDF Search Setup.

Convert Markdown ✨

• "Convert this README to wiki format"
• "Transform my release notes from Markdown to MediaWiki"
• "Convert with Tieto branding and CSS" (use theme="tieto", add_css=true)

Themes:

• tieto - Tieto brand colors (Hero Blue headings, yellow code highlights)
• neutral - Clean output without custom colors (default)
• dark - Dark mode optimized

Find Users

• "Who are the wiki admins?"
• "List all bot accounts"

Troubleshooting

"MEDIAWIKI_URL environment variable is required" → Check your config file has the correct path and URL.

"authentication failed" → Check username format: WikiUsername@BotName → Verify bot password hasn't expired → Ensure bot has required permissions

"page does not exist" → Page titles are case-sensitive. Check the exact title on your wiki.

Tools not appearing in Claude/Cursor → Restart the application after config changes.

ChatGPT can't connect → Ensure your server is publicly accessible (not just localhost) → Check the bearer token matches exactly

"PDF search requires 'pdftotext'" → Install poppler-utils for your platform (see PDF Search Setup)

PDF Search Setup

PDF search requires the pdftotext tool from poppler-utils. Text file search (TXT, MD, CSV, etc.) works without any dependencies.

Windows alternative: Download binaries from poppler-windows releases and add to PATH.

Verify installation:

pdftotext -v

Compatibility

Works with any wiki: Wikipedia, Fandom, corporate wikis, or any MediaWiki installation.

Advanced Configuration

HTTP Transport Options

For ChatGPT, n8n, and remote access, the server supports HTTP transport.

CLI Flags

Examples

# Basic HTTP server
./mediawiki-mcp-server -http :8080

# With authentication
./mediawiki-mcp-server -http :8080 -token "your-secret-token"

# Restrict to specific origins
./mediawiki-mcp-server -http :8080 -token "secret" \
  -origins "https://chat.openai.com,https://n8n.example.com"

# Bind to localhost only (for use behind reverse proxy)
./mediawiki-mcp-server -http 127.0.0.1:8080 -token "secret"

Security Best Practices

When exposing the server over HTTP:

1. Always Use Authentication

./mediawiki-mcp-server -http :8080 -token "$(openssl rand -hex 32)"

2. Use HTTPS via Reverse Proxy

Example nginx configuration:

server {
    listen 443 ssl;
    server_name mcp.example.com;

    ssl_certificate /path/to/cert.pem;
    ssl_certificate_key /path/to/key.pem;

    location / {
        proxy_pass http://127.0.0.1:8080;
        proxy_http_version 1.1;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

3. Restrict Origins

./mediawiki-mcp-server -http :8080 -token "secret" \
  -origins "https://chat.openai.com"

Built-in Security Features

Environment Variables

All Available Tools

"Find pages similar to the API Reference page"
→ Returns similarity scores, common terms, and linking recommendations

"Compare how 'timeout' is described across all pages"
→ Returns page mentions with context snippets and value mismatches

{
  "revision": {
    "old_revision": 1234,
    "new_revision": 1235,
    "diff_url": "https://wiki.../index.php?diff=1235&oldid=1234"
  },
  "undo": {
    "instruction": "To undo: use wiki URL or revert to revision 1234",
    "wiki_url": "https://wiki.../index.php?title=...&action=edit&undo=1235"
  }
}

Input:  "# Hello\n**bold** and *italic*"
Output: "= Hello =\n'''bold''' and ''italic''"

Public 360° Wiki (Tieto)

MEDIAWIKI_URL=https://wiki.software-innovation.com/api.php

Development

Build from Source

git clone https://github.com/olgasafonova/mediawiki-mcp-server.git
cd mediawiki-mcp-server
go build -o mediawiki-mcp-server .

Requires Go 1.23+

Project Structure

mediawiki-mcp-server/
├── main.go                    # Server entry point, HTTP transport
├── main_test.go               # Server tests
├── wiki_editing_guidelines.go # AI guidance for editing
│
├── tools/                     # MCP tool definitions
│   ├── definitions.go         # Tool schemas and metadata
│   ├── handlers.go            # Tool request handlers
│   └── registry.go            # Tool registration
│
├── wiki/                      # MediaWiki API client
│   ├── client.go              # HTTP client with auth
│   ├── config.go              # Configuration management
│   ├── types.go               # Request/response types
│   ├── errors.go              # Error handling
│   ├── read.go                # Page reading operations
│   ├── write.go               # Page editing operations
│   ├── search.go              # Search functionality
│   ├── methods.go             # Core API methods
│   ├── history.go             # Revision history
│   ├── categories.go          # Category operations
│   ├── users.go               # User management
│   ├── links.go               # Link analysis
│   ├── quality.go             # Content quality checks
│   ├── audit.go               # Wiki health audits
│   ├── similarity.go          # Content similarity detection
│   ├── pdf.go                 # PDF text extraction
│   ├── security.go            # Input sanitization, SSRF protection
│   └── *_test.go              # Comprehensive test coverage
│
├── converter/                 # Markdown to MediaWiki converter
│   ├── converter.go           # Conversion logic
│   ├── converter_test.go      # Tests
│   └── themes.go              # Theme definitions (tieto, neutral, dark)
│
├── cmd/
│   └── benchmark/             # Performance benchmarking
│       └── main.go
│
├── ARCHITECTURE.md            # System design documentation
├── CONTRIBUTING.md            # Contribution guidelines
├── SECURITY.md                # Security policy
├── WIKI_USE_CASES.md          # Usage examples by persona
└── README.md

License

MIT License

Credits

• Built with Go MCP SDK
• Powered by MediaWiki API