MediaWiki MCP-Server

Verbinden Sie Ihren KI-Assistenten mit jedem MediaWiki-Wiki. Suchen, lesen und bearbeiten Sie Wiki-Inhalte mithilfe natürlicher Sprache.

Funktioniert mit: Claude Desktop, Claude Code, Cursor, ChatGPT, n8n und jedem MCP-kompatiblen Tool.

Dokumentation

Related MCP server: productplan-mcp-server

Was können Sie tun?

Sobald die Verbindung hergestellt ist, fragen Sie einfach Ihre KI:

Erste Schritte

Schritt 1: Download

Option A: Vorkompiliertes Binary herunterladen (am einfachsten)

Gehen Sie zu Releases und laden Sie es für Ihre Plattform herunter.

Option B: Aus dem Quellcode bauen (erfordert Go 1.24+)

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

Schritt 2: API-URL Ihres Wikis finden

Die API-URL Ihres Wikis lautet normalerweise:

Tipp: Besuchen Sie Special:Version in Ihrem Wiki, um den genauen API-Endpunkt zu finden.

Schritt 3: Ihr KI-Tool konfigurieren

Wählen Sie Ihr Tool:

Claude Desktop

Funktioniert auf Mac und Windows. Nach der Ersteinrichtung ist kein Terminal mehr erforderlich.

1. Öffnen Sie die Konfigurationsdatei:

   open ~/Library/Application\ Support/Claude/claude_desktop_config.json

   Falls die Datei nicht existiert, erstellen Sie sie.

2. Fügen Sie diese Konfiguration hinzu (ersetzen Sie Pfad und URL):

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

3. Starten Sie Claude Desktop neu (beenden und erneut öffnen)

4. Testen Sie es: Fragen Sie "Suche im Wiki nach getting started"

1. Öffnen Sie die Konfigurationsdatei:

   %APPDATA%\Claude\claude_desktop_config.json

   Falls die Datei nicht existiert, erstellen Sie sie.

2. Fügen Sie diese Konfiguration hinzu (ersetzen Sie Pfad und URL):

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

3. Starten Sie Claude Desktop neu (beenden und erneut öffnen)

4. Testen Sie es: Fragen Sie "Suche im Wiki nach getting started"

Claude Code CLI

Das schnellste Setup. Ein Befehl und Sie sind fertig.

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

Testen Sie es: Fragen Sie "Suche im Wiki nach getting started"

Cursor

Cursor verfügt über integrierte MCP-Unterstützung. Öffnen Sie Cursor Settings > MCP und fügen Sie einen neuen Server hinzu oder bearbeiten Sie die Konfigurationsdatei direkt:

1. Öffnen Sie die Konfigurationsdatei:

   ~/.cursor/mcp.json

2. Fügen Sie diese Konfiguration hinzu:

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

3. Starten Sie Cursor neu

1. Öffnen Sie die Konfigurationsdatei:

   %USERPROFILE%\.cursor\mcp.json

2. Fügen Sie diese Konfiguration hinzu:

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

3. Starten Sie Cursor neu

ChatGPT

ChatGPT verbindet sich über HTTP. Sie müssen den Server auf einer Maschine ausführen, die ChatGPT erreichen kann.

Anforderungen: ChatGPT Pro, Plus, Business, Enterprise oder Education-Konto.

Setup

1. Starten Sie den Server im HTTP-Modus:

   # 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:

   • Gehen Sie zu Settings → Connectors → Advanced → Developer Mode

   • Fügen Sie einen neuen MCP-Connector hinzu

   • URL: http://your-server:8080 (muss öffentlich zugänglich sein)

   • Authentifizierung: Bearer-Token → fügen Sie Ihr Token ein

3. Testen Sie es: Fragen Sie "Suche im Wiki nach getting started"

Für die Produktion: Siehe Security Best Practices für das HTTPS-Setup.

n8n

n8n verbindet sich über HTTP unter Verwendung des MCP Client Tool-Nodes.

Setup

1. Starten Sie den Server im HTTP-Modus:

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

2. In n8n:

   • Fügen Sie einen MCP Client Tool-Node hinzu

   • Transport: HTTP Streamable

   • URL: http://your-server:8080

   • Authentifizierung: Bearer → Ihr Token

3. Für KI-Agenten aktivieren (zur n8n-Umgebung hinzufügen):

   N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

4. Verbinden Sie das MCP Client Tool mit einem KI-Agenten-Node.

VS Code

VS Code verfügt über integrierte MCP-Unterstützung via Copilot Chat.

1. Öffnen Sie die Befehlspalette: Strg+Umschalt+P (Windows) oder Cmd+Umschalt+P (Mac)

2. Geben Sie "MCP: Add Server" ein und wählen Sie es aus

3. Wählen Sie "Stdio" als Transporttyp

4. Geben Sie bei Aufforderung den Pfad zum Binary ein

5. Benennen Sie den Server: mediawiki

Dies erstellt eine .vscode/mcp.json-Datei. Fügen Sie die Umgebungsvariablen hinzu:

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

Verwenden Sie unter Windows den .exe-Pfad mit doppelten Backslashes.

Starten Sie VS Code neu und verwenden Sie dann die Wiki-Tools über Copilot Chat.

Google ADK

Googles Agent Development Kit verbindet sich mit MCP-Servern über Stdio oder 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},
})

Starten Sie zuerst den Server im HTTP-Modus:

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

Verbinden Sie sich dann von Ihrem ADK-Agenten aus:

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

Starten Sie den Server im HTTP-Modus, dann:

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

Müssen Sie Wiki-Seiten bearbeiten?

Das Lesen funktioniert auf öffentlichen Wikis ohne Login. Private/Unternehmens-Wikis erfordern oft eine Authentifizierung für alle Vorgänge, einschließlich des Lesens. Das Bearbeiten erfordert immer ein Bot-Passwort.

Erstellen Sie ein Bot-Passwort

1. Melden Sie sich bei Ihrem Wiki an

2. Gehen Sie zu Special:BotPasswords (z. B. https://your-wiki.com/wiki/Special:BotPasswords)

3. Geben Sie einen Bot-Namen ein: mcp-assistant

4. Aktivieren Sie diese Berechtigungen:

   • ✅ Grundlegende Rechte

   • ✅ Bestehende Seiten bearbeiten

5. Klicken Sie auf Erstellen und speichern Sie das Passwort (Sie werden es nicht erneut sehen)

Fügen Sie Anmeldedaten zu Ihrer Konfiguration hinzu

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"

Beispiel-Prompts

📖 Weitere Beispiele: Siehe WIKI_USE_CASES.md für detaillierte Workflows nach Personas (Inhaltsredakteure, Dokumentationsmanager, Entwickler).

Suchen & Lesen

• "Was sagt unser Wiki über Deployment?"

• "Finde alle Seiten, die die API erwähnen"

• "Zeig mir den Getting Started-Guide"

• "Liste alle Seiten in der Kategorie Dokumentation auf"

• "Gib mir einen kurzen Überblick über die Konfigurationsseite" ✨

• "Hole den Inhalt der Hauptseite, FAQ und Setup auf einmal" ✨

Abschnitte & verwandte Inhalte ✨

• "Zeig mir die Abschnitte des Installationshandbuchs"

• "Hole den Abschnitt 'Troubleshooting' von der FAQ-Seite"

• "Finde Seiten, die sich auf die API-Referenz beziehen"

• "Welche Bilder befinden sich auf der Produktübersichtsseite?"

Änderungen verfolgen

• "Welche Seiten wurden diese Woche aktualisiert?"

• "Wer hat die Release Notes-Seite bearbeitet?"

• "Zeig mir den Diff zwischen den letzten beiden Versionen"

• "Wer sind die aktivsten Editoren diesen Monat?" ✨

• "Welche Seiten werden am häufigsten bearbeitet?" ✨

Qualität prüfen

• "Gibt es defekte Links auf dieser Seite?"

• "Finde verwaiste Seiten ohne Links darauf"

• "Überprüfe die Konsistenz der Terminologie in der Produktkategorie"

• "Finde Seiten, die dem Installationshandbuch ähnlich sind" ✨

• "Vergleiche, wie 'API-Version' über Seiten hinweg dokumentiert ist" ✨

• "Finde Seiten, die in den letzten 90 Tagen nicht aktualisiert wurden" ✨

Seitenverwaltung (erfordert Auth) ✨

• "Benenne 'Alter Guide' in 'Aktualisierter Guide' um"

• "Füge die Kategorie 'API' zur Integrationsseite hinzu"

• "Entferne die Kategorie 'Veraltet' von dieser Seite"

Schnelle Bearbeitungen (erfordert Auth)

• "Streiche John Smith auf der Team-Seite durch"

• "Ersetze 'Version 2.0' durch 'Version 3.0' in den Release Notes"

• "Mache 'API Gateway' auf der Architektur-Seite fett"

Datei-Uploads (erfordert Auth) ✨

• "Lade dieses Bild von der URL ins Wiki hoch"

• "Füge das Logo von https://example.com/logo.png als Company_Logo.png hinzu"

Dateisuche ✨

• "Suche nach 'Budget' in File:Annual-Report.pdf"

• "Finde Erwähnungen von 'API' in der Datei changelog.txt"

Hinweis: Die PDF-Suche erfordert installierte poppler-utils. Siehe PDF Search Setup.

Markdown konvertieren ✨

• "Konvertiere dieses README in das Wiki-Format"

• "Transformiere meine Release Notes von Markdown zu MediaWiki"

• "Konvertiere mit Tieto-Branding und CSS" (verwende theme="tieto", add_css=true)

Themes:

• tieto - Tieto-Markenfarben (Hero Blue Überschriften, gelbe Code-Highlights)

• neutral - Saubere Ausgabe ohne benutzerdefinierte Farben (Standard)

• dark - Optimiert für den Dark Mode

Benutzer finden

• "Wer sind die Wiki-Admins?"

• "Liste alle Bot-Konten auf"

Fehlerbehebung

"MEDIAWIKI_URL environment variable is required" → Überprüfen Sie, ob Ihre Konfigurationsdatei den korrekten Pfad und die URL enthält.

"authentication failed" → Überprüfen Sie das Format des Benutzernamens: WikiUsername@BotName → Überprüfen Sie, ob das Bot-Passwort abgelaufen ist → Stellen Sie sicher, dass der Bot über die erforderlichen Berechtigungen verfügt

"page does not exist" → Seitentitel unterscheiden zwischen Groß- und Kleinschreibung. Überprüfen Sie den genauen Titel in