Connect your AI assistant to any MediaWiki wiki, or script it directly from the terminal. Search, read, and edit wiki content using natural language or the wiki CLI.

CI Go Report Card License: MIT

Works with: Claude Desktop, Claude Code, Cursor, ChatGPT, n8n, and any MCP-compatible tool. Also ships a wiki CLI for shell scripts and CI pipelines, see Use from the Terminal.

Documentation

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

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

Cursor has built-in MCP support. Open Cursor Settings > MCP and add a new server, or edit the config file directly:

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

VS Code has built-in MCP support via Copilot Chat.

1. Open the Command Palette: Ctrl+Shift+P (Windows) or Cmd+Shift+P (Mac)
2. Type "MCP: Add Server" and select it
3. Choose "Stdio" as the transport type
4. Enter the path to the binary when prompted
5. Name the server: mediawiki

This creates a .vscode/mcp.json file. Add the environment variables:

{
  "servers": {
    "mediawiki": {
      "command": "/path/to/mediawiki-mcp-server",
      "env": {
        "MEDIAWIKI_URL": "https://your-wiki.com/api.php"
      }
    }
  }
}

On Windows, use the .exe path with double backslashes.

Reload VS Code, then use the wiki tools through Copilot Chat.

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"},
    )
)

Use from the Terminal

The wiki CLI is a command-line companion to the MCP server. It shares the same API client, auth, and configuration. Reach for it when a prompt is overkill: shell pipelines, CI checks, batch edits, cron jobs.

Install

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

Configure

The CLI reads the same environment variables as the MCP server.

export MEDIAWIKI_URL="https://your-wiki.com/api.php"

# Optional, for write operations
export MEDIAWIKI_USERNAME="User@BotName"
export MEDIAWIKI_PASSWORD="your-bot-password"

wiki config         # verify setup

You can also override the URL per-invocation with --url.

Commands

Every command supports --json (machine-readable output) and --quiet (errors only).

Examples

# Pipe lint results into CI
wiki lint "Release Notes" --json > lint.json

# Find broken external links as structured data
wiki links broken --json | jq '.[] | select(.status >= 400)'

# Publish a Markdown file
wiki publish docs/onboarding.md --title "Onboarding"

# Cron-friendly health check
wiki audit --quiet --json > /tmp/wiki-health.json

Run wiki <command> --help for full flags.

Need to Edit Wiki Pages?

Reading works without login on public wikis. Private/corporate wikis often require authentication for all operations, including reading. Editing always 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 WIKI_USE_CASES.md 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"
• "Give me a quick overview of the Configuration page" ✨
• "Get the content of Main Page, FAQ, and Setup all at once" ✨

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" ✨
• "Find pages not updated in the last 90 days" ✨

Page Management (requires auth) ✨

• "Rename 'Old Guide' to 'Updated Guide'"
• "Add category 'API' to the Integration page"
• "Remove the 'Deprecated' category from this page"

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

HTTP Endpoints

When running in HTTP mode, these endpoints are available:

Health Checks

Use /health and /ready for container orchestration:

# Kubernetes example
livenessProbe:
  httpGet:
    path: /health
    port: 8080
readinessProbe:
  httpGet:
    path: /ready
    port: 8080

Tool Discovery

Get a list of all available tools:

curl http://localhost:8080/tools | jq '.categories | keys'

Resilience Monitoring

Check circuit breaker and request deduplication status:

curl http://localhost:8080/status
# Returns: {"circuit_breaker":{"state":"closed",...},"inflight_requests":0}

Environment Variables

All Available Tools

"What does the wiki say about deployment?"
→ Searches, reads top result, returns content + remaining hits as summaries

"What is the API Reference page about?"
→ Returns intro section, categories, section list, and metadata

"Get the content of Main Page, FAQ, and Getting Started"
→ Returns all three pages in a single API request

"Find pages not updated in 90 days"
→ Returns stale pages sorted oldest-first with days since last edit

"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"
  }
}

"Rename 'Old Guide' to 'Updated Guide'"
→ Moves page, creates redirect, optionally moves talk page

"Add category 'API' and remove category 'Deprecated' from this page"
→ Modifies categories without touching page content

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

Public 360° Wiki (Tieto)

New to this? Check out the Tieto Setup Guide for step-by-step instructions that assume no technical knowledge.

claude mcp add mediawiki /path/to/mediawiki-mcp-server \
  -e MEDIAWIKI_URL="https://wiki.software-innovation.com/api.php" \
  -e MEDIAWIKI_USERNAME="[email protected]#wiki-MCP" \
  -e MEDIAWIKI_PASSWORD="your-bot-password-here"

{
  "mcpServers": {
    "mediawiki": {
      "command": "/path/to/mediawiki-mcp-server",
      "env": {
        "MEDIAWIKI_URL": "https://wiki.software-innovation.com/api.php",
        "MEDIAWIKI_USERNAME": "[email protected]#wiki-MCP",
        "MEDIAWIKI_PASSWORD": "your-bot-password-here"
      }
    }
  }
}

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.24+

Running Tests

# Unit tests
make test

# With coverage
make test-cover

# Lint
make lint

Integration Tests

Integration tests run against a real MediaWiki instance:

# Start MediaWiki container
docker-compose -f docker-compose.test.yml up -d

# Wait for MediaWiki to be ready (about 60 seconds)
# Run integration tests
go test -tags=integration ./wiki/...

# Stop and clean up
docker-compose -f docker-compose.test.yml down -v

Integration tests can also be triggered manually via GitHub Actions.

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
├── docker-compose.test.yml    # Integration test environment
│
├── .github/workflows/
│   ├── ci.yml                 # Unit tests, lint, build
│   └── integration.yml        # Integration tests (manual trigger)
│
├── scripts/
│   └── LocalSettings.php      # MediaWiki config for tests
│
├── 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
│   ├── integration_test.go    # Integration tests (build tag)
│   └── *_test.go              # Unit tests
│
├── 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

Like This Project?

If this server saved you time, consider giving it a ⭐ on GitHub. It helps others discover the project.

More MCP Servers

Check out my other MCP servers:

Server	Description	Stars
gleif-mcp-server	Access GLEIF LEI database. Look up company identities, verify legal entities.
miro-mcp-server	Control Miro whiteboards with AI. Boards, diagrams, mindmaps, and more.
nordic-registry-mcp-server	Access Nordic business registries. Look up companies across Norway, Denmark, Finland, Sweden.
productplan-mcp-server	Talk to your ProductPlan roadmaps. Query OKRs, ideas, launches.
tilbudstrolden-mcp	Nordic grocery deal hunting. Find offers, plan meals, track spending.
mcp-servercard-go	Go library for SEP-2127 Server Cards. Pre-connect discovery for MCP servers.

License

MIT License

Credits

• Built with Go MCP SDK
• Powered by MediaWiki API