MediaWiki MCPサーバー

AIアシスタントをあらゆるMediaWiki Wikiに接続します。自然言語を使用してWikiコンテンツの検索、読み取り、編集が可能です。

対応ツール: Claude Desktop、Claude Code、Cursor、ChatGPT、n8n、およびMCP互換ツール全般。

ドキュメント

Related MCP server: productplan-mcp-server

何ができるのか？

接続後、AIに次のように話しかけるだけです：

はじめに

ステップ 1: ダウンロード

オプションA: ビルド済みバイナリをダウンロード（最も簡単）

Releases にアクセスし、お使いのプラットフォーム用のファイルをダウンロードしてください。

オプションB: ソースからビルド（Go 1.24+が必要）

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

ステップ 2: WikiのAPI URLを確認する

WikiのAPI URLは通常以下の通りです：

ヒント: Wikiの Special:Version にアクセスすると、正確なAPIエンドポイントを確認できます。

ステップ 3: AIツールを設定する

ツールを選択:

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

最速の設定方法です。コマンド1つで完了します。

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" と尋ねる

本番環境向け: HTTPS設定については Security Best Practices を参照してください。

n8n

n8nはMCP Client Toolノードを使用してHTTP経由で接続します。

設定

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. AIエージェントで有効化 (n8n環境に追加):

   N8N_COMMUNITY_PACKAGES_ALLOW_TOOL_USAGE=true

4. MCP Client ToolをAIエージェントノードに接続します。

VS Code

VS CodeにはCopilot Chat経由でMCPサポートが組み込まれています。

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を通じてWikiツールを使用します。

Google ADK

Googleの Agent Development Kit は、stdioまたはStreamable HTTP経由でMCPサーバーに接続します。

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

Wikiページの編集が必要ですか？

公開Wikiではログインなしで読み取りが可能です。プライベート/企業用Wikiでは、読み取りを含むすべての操作に認証が必要な場合が多いです。 編集には常にボットパスワードが必要です。

ボットパスワードの作成

1. Wikiにログイン

2. Special:BotPasswords に移動 (例: https://your-wiki.com/wiki/Special:BotPasswords)

3. ボット名を入力: mcp-assistant

4. 以下の権限にチェックを入れる:

   • ✅ 基本権限

   • ✅ 既存ページの編集

5. 作成 をクリックし、パスワードを保存 してください（二度と表示されません）

設定に認証情報を追加

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 を参照してください。

検索と読み取り

• "デプロイについてWikiには何と書いてある？"

• "APIについて言及しているページをすべて探して"

• "Getting Startedガイドを見せて"

• "Documentationカテゴリの全ページをリストアップして"

• "Configurationページの概要を教えて" ✨

• "Main Page、FAQ、Setupの内容を一度に取得して" ✨

セクションと関連コンテンツ ✨

• "Installation Guideのセクションを見せて"

• "FAQページから'Troubleshooting'セクションを取得して"

• "API Referenceに関連するページを探して"

• "Product Overviewページにはどんな画像がある？"

変更の追跡

• "今週更新されたページは？"

• "Release Notesページを編集したのは誰？"

• "直近2つのバージョンの差分を見せて"

• "今月最もアクティブな編集者は誰？" ✨

• "最も頻繁に編集されているページは？" ✨

品質のチェック

• "このページにリンク切れはある？"

• "リンクされていない孤立ページを探して"

• "Productカテゴリの用語の一貫性をチェックして"

• "Installation Guideに似たページを探して" ✨

• "'API version'がページ間でどのようにドキュメント化されているか比較して" ✨

• "過去90日間更新されていないページを探して" ✨

ページ管理 (認証が必要) ✨

• "'Old Guide'を'Updated Guide'にリネームして"

• "Integrationページに'API'カテゴリを追加して"

• "このページから'Deprecated'カテゴリを削除して"

クイック編集 (認証が必要)

• "チームページでJohn Smithに取り消し線を引いて"

• "Release Notesの'version 2.0'を'version 3.0'に置き換えて"

• "Architectureページの'API Gateway'を太字にして"

ファイルアップロード (認証が必要) ✨

• "このURLの画像をWikiにアップロードして"

• "https://example.com/logo.png のロゴを Company_Logo.png として追加して"

ファイル検索 ✨

• "File:Annual-Report.pdf 内で'budget'を検索して"

• "changelog.txt ファイル内で'API'への言及を探して"

注: PDF検索には poppler-utils のインストールが必要です。PDF Search Setup を参照してください。

Markdown変換 ✨

• "このREADMEをWiki形式に変換して"

• "リリースノートをMarkdownからMediaWikiに変換して"

• "TietoのブランディングとCSSで変換して" (theme="tieto", add_css=true)

テーマ:

• tieto - Tietoブランドカラー（Hero Blueの見出し、黄色のコードハイライト）

• neutral - カスタムカラーなしのクリーンな出力（デフォルト）

• dark - ダークモード最適化

例:

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

MarkdownコンテンツをWikiに追加するワークフロー:

1. 変換: mediawiki_convert_markdown → ウィキテキストを取得

2. 保存: mediawiki_edit_page → Wikiに公開

Public 360° Wiki (Tieto)

初めてですか？ 技術的な知識がなくてもステップバイステップで進められる Tieto Setup Guide を確認してください。

ボットパスワードを取得

1. Special:BotPasswords に移動

2. Tietoアカウントでログイン

3. wiki-MCP という名前のボットを作成

4. 有効化: 基本権限 + 既存ページの編集

5. 生成されたパスワードを保存

ユーザー名: your.email@tietoevry.com#wiki-MCP

設定

このWikiはすべての操作（読み取りを含む）に認証が必要です。

Claude Code CLI:

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

Claude Desktop / Cursor:

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

プロンプト例

• "eFormidlingに関する全ページを探して"

• "AutoSaverについてWikiには何と書いてある？"

• "APIドキュメントのリンク切れをチェックして"

開発

ソースからビルド

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

Go 1.24+ が必要です

テストの実行

# Unit tests
make test

# With coverage
make test-cover

# Lint
make lint

統合テスト

統合テスト