MediaWiki MCP Server

Подключите своего ИИ-ассистента к любой вики на базе MediaWiki. Ищите, читайте и редактируйте контент вики, используя естественный язык.

Работает с: Claude Desktop, Claude Code, Cursor, ChatGPT, n8n и любыми инструментами, совместимыми с MCP.

Документация

Related MCP server: productplan-mcp-server

Что вы можете делать?

После подключения просто спросите свой ИИ:

Начало работы

Шаг 1: Загрузка

Вариант А: Загрузка готового бинарного файла (самый простой)

Перейдите в Releases и загрузите файл для вашей платформы.

Вариант Б: Сборка из исходного кода (требуется Go 1.24+)

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

Шаг 2: Найдите API URL вашей вики

API URL вашей вики обычно выглядит так:

Совет: Посетите Special:Version на вашей вики, чтобы найти точный адрес API.

Шаг 3: Настройте ваш ИИ-инструмент

Выберите ваш инструмент:

Claude Desktop

Работает на Mac и Windows. После первоначальной настройки терминал не требуется.

1. Откройте файл конфигурации:

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

   Если файл не существует, создайте его.

2. Добавьте эту конфигурацию (замените путь и URL):

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

3. Перезапустите Claude Desktop (закройте и откройте снова)

4. Проверьте: Спросите "Search the wiki for getting started"

1. Откройте файл конфигурации:

   %APPDATA%\Claude\claude_desktop_config.json

   Если файл не существует, создайте его.

2. Добавьте эту конфигурацию (замените путь и URL):

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

3. Перезапустите Claude Desktop (закройте и откройте снова)

4. Проверьте: Спросите "Search the wiki for getting started"

Claude Code CLI

Самая быстрая настройка. Одна команда — и готово.

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

Проверьте: Спросите "Search the wiki for getting started"

Cursor

В Cursor встроена поддержка MCP. Откройте Cursor Settings > MCP и добавьте новый сервер или отредактируйте файл конфигурации напрямую:

1. Откройте файл конфигурации:

   ~/.cursor/mcp.json

2. Добавьте эту конфигурацию:

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

3. Перезапустите Cursor

1. Откройте файл конфигурации:

   %USERPROFILE%\.cursor\mcp.json

2. Добавьте эту конфигурацию:

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

3. Перезапустите Cursor

ChatGPT

ChatGPT подключается через HTTP. Вам нужно запустить сервер на машине, к которой ChatGPT имеет доступ.

Требования: Аккаунт ChatGPT Pro, Plus, Business, Enterprise или Education.

Настройка

1. Запустите сервер в режиме HTTP:

   # 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. В ChatGPT:

   • Перейдите в Settings → Connectors → Advanced → Developer Mode

   • Добавьте новый MCP-коннектор

   • URL: http://your-server:8080 (должен быть доступен извне)

   • Authentication: Bearer token → вставьте ваш токен

3. Проверьте: Спросите "Search the wiki for getting started"

Для продакшена: См. Security Best Practices для настройки HTTPS.

n8n

n8n подключается через HTTP с помощью узла MCP Client Tool.

Настройка

1. Запустите сервер в режиме HTTP:

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

2. В n8n:

   • Добавьте узел MCP Client Tool

   • Transport: HTTP Streamable

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

   • Authentication: Bearer → ваш токен

3. Включите для ИИ-агентов (добавьте в окружение n8n):

   N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

4. Подключите MCP Client Tool к узлу AI Agent.

VS Code

В VS Code встроена поддержка MCP через Copilot Chat.

1. Откройте палитру команд: Ctrl+Shift+P (Windows) или Cmd+Shift+P (Mac)

2. Введите "MCP: Add Server" и выберите его

3. Выберите "Stdio" в качестве типа транспорта

4. Введите путь к бинарному файлу при запросе

5. Назовите сервер: mediawiki

Это создаст файл .vscode/mcp.json. Добавьте переменные окружения:

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

В Windows используйте путь к .exe с двойными обратными слэшами.

Перезагрузите VS Code, затем используйте инструменты вики через Copilot Chat.

Google ADK

Agent Development Kit от Google подключается к MCP-серверам через stdio или 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},
})

Сначала запустите сервер в режиме HTTP:

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

Затем подключитесь из вашего агента ADK:

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

Запустите сервер в режиме HTTP, затем:

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

Нужно редактировать страницы вики?

Чтение работает без логина на публичных вики. Частные/корпоративные вики часто требуют авторизации для всех операций, включая чтение. Редактирование всегда требует пароль бота.

Создайте пароль бота

1. Войдите в свою вики

2. Перейдите в Special:BotPasswords (например, https://your-wiki.com/wiki/Special:BotPasswords)

3. Введите имя бота: mcp-assistant

4. Отметьте эти права:

   • ✅ Базовые права

   • ✅ Редактирование существующих страниц

5. Нажмите Create и сохраните пароль (вы больше не сможете его увидеть)

Добавьте учетные данные в конфигурацию

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"

Примеры промптов

📖 Больше примеров: См. WIKI_USE_CASES.md для подробных рабочих процессов по ролям (редакторы контента, менеджеры документации, разработчики).

Поиск и чтение

• "Что в нашей вики говорится о развертывании?"

• "Найди все страницы, где упоминается API"

• "Покажи мне руководство по началу работы"

• "Выведи список всех страниц в категории Документация"

• "Дай мне краткий обзор страницы Конфигурация" ✨

• "Получи содержимое Главной страницы, FAQ и Setup одновременно" ✨

Разделы и связанный контент ✨

• "Покажи мне разделы Руководства по установке"

• "Получи раздел 'Устранение неполадок' со страницы FAQ"

• "Найди страницы, связанные со Справочником API"

• "Какие изображения есть на странице Обзор продукта?"

Отслеживание изменений

• "Какие страницы были обновлены на этой неделе?"

• "Кто редактировал страницу Release Notes?"

• "Покажи мне разницу между последними двумя версиями"

• "Кто самые активные редакторы в этом месяце?" ✨

• "Какие страницы редактируются чаще всего?" ✨

Проверка качества

• "Есть ли на этой странице битые ссылки?"

• "Найди страницы-сироты, на которые нет ссылок"

• "Проверь согласованность терминологии в категории Продукт"

• "Найди страницы, похожие на Руководство по установке" ✨

• "Сравни, как 'версия API' задокументирована на разных страницах" ✨

• "Найди страницы, которые не обновлялись последние 90 дней" ✨

Управление страницами (требуется авторизация) ✨

• "Переименуй 'Старое руководство' в 'Обновленное руководство'"

• "Добавь категорию 'API' на страницу Интеграция"

• "Удали категорию 'Устаревшее' с этой страницы"

Быстрое редактирование (требуется авторизация)

• "Зачеркни Джона Смита на странице Команда"

• "Замени 'версия 2.0' на 'версия 3.0' в Release Notes"

• "Сделай 'API Gateway' жирным на странице Архитектура"

Загрузка файлов (требуется авторизация) ✨

• "Загрузи это изображение по URL в вики"

• "Добавь логотип с https://example.com/logo.png как Company_Logo.png"

Поиск по файлам ✨

• "Ищи 'бюджет' в File:Annual-Report.pdf"

• "Найди упоминания 'API' в файле changelog.txt"

Примечание: Для поиска по PDF требуется установленный poppler-utils. См. PDF Search Setup.

Преобразование Markdown ✨

• "Преобразуй этот README в формат вики"

• "Преобразуй мои примечания к выпуску из Markdown в MediaWiki"

• "Преобразуй с брендингом Tieto и CSS" (используйте theme="tieto", add_css=true)

Темы:

• tieto - Фирменные цвета Tieto (заголовки Hero Blue, желтая подсветка кода)

• neutral - Чистый вывод без пользовательских цветов (по умолчанию)

• dark - Оптимизировано для темной темы

Поиск пользователей

• "Кто администраторы вики?"

• "Выведи список всех ботов"

Устранение неполадок

"MEDIAWIKI_URL environment variable is required" → Проверьте, что в файле конфигурации указан правильный путь и URL.

"authentication failed" → Проверьте формат имени пользователя: WikiUsername@BotName → Убедитесь, что пароль бота не истек → Убедитесь, что у бота есть необходимые права

"page does not exist" → Заголовки страниц чувствительны к регистру. Проверьте точное название на вашей вики.

Инструменты не появляются в Claude/Cursor → Перезапустите приложение после внесения изменений в конфигурацию.

**