MediaWiki MCP Server

MediaWiki MCP Server

LLM クライアントが任意の MediaWiki ウィキとやり取りできるようにする MCP（Model Context Protocol）サーバーです。

機能

ツール

ウィキを操作する各ツールでは、操作対象のウィキを指定する任意の wiki 引数を受け付けます（ウィキ管理ツールと OAuth ツールを除く）。ウィキキー（例：en.wikipedia.org）または完全な mcp://wikis/{wikiKey} URI を渡してください。省略すると、設定済みのデフォルトウィキが使われます（設定を参照）。各ツールの応答には、呼び出しが実行されたウィキが示されます。成功した応答では、ペイロードが content には文章として、structuredContent には JSON として格納されます。応答チャネルを参照してください。

ページの読み取り

ページの書き込み

ウィキの管理

OAuth

拡張パック

各パックのツールは、その拡張機能がインストールされている Wiki でのみ登録されます。

NeoWiki

Semantic MediaWiki

Bucket

Cargo

Wikibase

リソース

mcp://wikis/{wikiKey} — Wiki ごとのリソースです。sitename、server（Wiki の公開アドレス）、articlepath、scriptpath、および private と readOnly のフラグを公開します。

• 公開されるフィールドはこれだけです。リソースが公開するリストは固定されているため、設定ファイル内の認証情報やサーバー側の設定がリソースの内容に含まれることはありません。
• add-wiki または remove-wiki の後、サーバーは notifications/resources/list_changed を送信し、クライアントに更新を促します。

{
  "contents": [
    {
      "uri": "mcp://wikis/en.wikipedia.org",
      "mimeType": "application/json",
      "text": "{ \"sitename\":\"Wikipedia\",\"server\":\"https://en.wikipedia.org\",\"articlepath\":\"/wiki\",\"scriptpath\":\"/w\",\"private\":false }"
    }
  ]
}

以下の変数は、どのセットアップにも関係します。HTTP トランスポートをセルフホストする場合（ポート、タイムアウト、Host／Origin、SSRF ガード）またはホスト型 OAuth プロキシを実行する場合にのみ適用される変数については、docs/deployment.md — environment variables を参照してください。設定ファイル内の置換とアップロードディレクトリの変数については、docs/configuration.md を参照してください。

設定

メモ

プライベートウィキと対話する場合、または認証が必要なツールを使用する場合にのみ、設定が必要です。

ウィキ接続を設定するには、config.json ファイルを作成してください。出発点として config.example.json を使用してください。

{
  "defaultWiki": "en.wikipedia.org",
  "wikis": {
    "en.wikipedia.org": {
      "sitename": "Wikipedia",
      "server": "https://en.wikipedia.org",
      "articlepath": "/wiki",
      "scriptpath": "/w"
    }
  }
}

内部アドレスと公開アドレス。 設定する server には内部ホスト名（例：Docker 内の http://mediawiki）を指定できます。呼び出し元に返される URL はウィキの公開アドレスから生成されるため、内部ホストが MCP_TRUSTED_HOSTS に含まれていれば、リンクに内部ホスト名が漏れることはありません。docs/configuration.md — per-wiki fields を参照してください。

すべてのフィールドのリファレンス、環境変数の置換、シークレットソース、変更タグ、アップロードディレクトリ、認証オプションについては、docs/configuration.md を参照してください。

認証

🔐 が付いたツールには認証が必要です。書き込みツール（拡張機能パックへの書き込みを含む）は、readOnly: true が設定されたウィキでは拒否され、設定済みのすべてのウィキでこの設定が有効な場合は tools/list から非表示になります。詳しくはデプロイをご覧ください。

• ブラウザーベースの OAuth（推奨）。 ツールで初めて認証が必要になったときに、ブラウザータブからサインインします。ウィキごとに oauth2ClientId と oauth2CallbackPort を設定してください。詳しくはdocs/configuration.md — OAuth（ブラウザーベース）をご覧ください。
• リクエストごとのベアラートークン（HTTP、非推奨）。 各リクエストに Authorization: Bearer <token> を含め、サーバーがそれを MediaWiki に転送します。MCP サーバーは、自分宛てに発行されていないトークンを受け付けてはならないため、既定では無効です。詳しくはdocs/deployment.md — リクエストごとのベアラートークンをご覧ください。
• ホスト型 OAuth プロキシ（HTTP）。 サーバーは 1 つの MediaWiki コンシューマーの前段で OAuth 2.1 認可サーバーとして動作するため、OAuth 対応クライアントで各ユーザーがサインインできます。手動でトークンを入力する必要はありません。https://<wiki>/mcp を指定してください。匿名での読み取りも引き続き利用できます。詳しくはdocs/deployment.md — ホスト型 OAuth サインインをご覧ください。
• 手動 OAuth2 アクセストークン。 長期間有効なトークンを config.json に貼り付けます。詳しくはdocs/configuration.md — 手動 OAuth2 アクセストークンをご覧ください。
• ボットパスワード。 Extension:OAuth がインストールされていない場合の代替手段です。詳しくはdocs/configuration.md — ボットパスワードをご覧ください。

cargo-query を使うには、すべてのユーザーによる Cargo クエリの実行を許可しているウィキであっても、ボットパスワードまたは OAuth コンシューマーに Create, query and delete data through the Cargo extension 権限が必要です。Cargo 拡張機能は、Cargo のフォークである wiki.gg の LIBRARIAN を実行する wiki.gg のウィキでも検出されます。

インストール

以下からクライアントを選ぶか、一覧にない場合は標準設定を使用してください。CONFIG は省略可能です。省略すると、サーバーは英語版 Wikipedia を対象とします。独自のウィキを指定して書き込み用の認証を設定する方法については、docs/configuration.mdをご覧ください。

Claude Code

このリポジトリをプラグインマーケットプレイスとして追加し、同梱のサーバーをインストールします。

/plugin marketplace add ProfessionalWiki/MediaWiki-MCP-Server
/plugin install mediawiki-mcp-server@professional-wiki

プラグインには、サーバーを独自のウィキに接続するための設定ファイルを指定できます。プラグインを有効にするときにプロンプトから設定するか、いつでも /plugin configure mediawiki-mcp-server@professional-wiki を実行して設定してください。コマンドラインからインストールする場合は、同じ値を claude plugin install mediawiki-mcp-server@professional-wiki --config configPath=path/to/config.json で指定します。

プラグインとしてインストールすると、ツールの名前空間は mcp__plugin_mediawiki-mcp-server_mediawiki__<tool> になります。ツールの許可リストやフックを適宜更新してください。

代わりにサーバーを直接設定する方法については、Claude Code MCP docsをご覧ください。概要は次のとおりです。

claude mcp add mediawiki-mcp-server -- npx -y @professional-wiki/mediawiki-mcp-server@latest
# Environment variables go before the `--`:
claude mcp add mediawiki-mcp-server -e CONFIG=path/to/config.json -- npx -y @professional-wiki/mediawiki-mcp-server@latest

Codex

このリポジトリをプラグインマーケットプレイスとして追加し、同梱のサーバーをインストールします。

codex plugin marketplace add ProfessionalWiki/MediaWiki-MCP-Server
codex plugin add mediawiki-mcp-server@professional-wiki

プラグインを独自のウィキに接続するには、Codex を起動するシェルで CONFIG を設定します。たとえば、export CONFIG=path/to/config.json を実行します。Codex にはプラグインごとの設定機能がありません。環境変数を設定したくない場合は、codex mcp add mediawiki --env CONFIG=path/to/config.json -- npx -y @professional-wiki/mediawiki-mcp-server@latest を実行してサーバーを直接登録できます。この設定はプラグイン側の設定より優先されます。

プラグインの一覧表示、更新、削除については、Codex plugins documentationをご覧ください。

Claude Desktop

MediaWiki-MCP-Server.mcpb をダウンロードしてダブルクリックすると、拡張機能がインストールされます。インストール時に設定ファイルのパスを尋ねられるので、英語版 Wikipedia ではなく独自のウィキを指定できます。

VS Code と Cursor

または、標準設定を手動で追加してください。

Antigravity

標準設定を Antigravity の MCP 設定に追加します。グローバルに設定する場合は ~/.gemini/config/mcp_config.json に、ワークスペースごとに設定する場合は .agents/mcp_config.json に追加してください。

以前に Gemini CLI 拡張機能をインストールしている場合、Antigravity のセットアップウィザードで既存の Gemini CLI 設定をインポートできます。

OpenCode

OpenCode は mcpServers ではなく独自の設定形式を使用します。プロジェクトのルートにある opencode.json、またはグローバルにインストールする場合は ~/.config/opencode/opencode.json に追加してください。

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mediawiki-mcp-server": {
      "type": "local",
      "command": ["npx", "-y", "@professional-wiki/mediawiki-mcp-server@latest"],
      "environment": {
        "CONFIG": "path/to/config.json"
      }
    }
  }
}

標準設定

ほとんどのクライアントでは、同じサーバーブロックを使用します。クライアント用に記載されたファイルに貼り付け、mcpServers をそのクライアントのルートキーに置き換えてください。

{
  "mcpServers": {
    "mediawiki-mcp-server": {
      "command": "npx",
      "args": ["-y", "@professional-wiki/mediawiki-mcp-server@latest"],
      "env": {
        "CONFIG": "path/to/config.json"
      }
    }
  }
}

その他のクライアントでは、npx add-mcp @professional-wiki/mediawiki-mcp-server が使える場合があります。add-mcp は、クライアントの設定ファイルを書き込むコミュニティ製 CLI です。起動コマンドのみを設定するため、自分のウィキを指定する CONFIG はご自身で追加してください。

デプロイ

他のユーザーが利用できるリモート HTTP エンドポイントとしてサーバーを実行するには、独自の設定が必要です。docs/deployment.md を参照してください。ビルド済みイメージは ghcr.io/professionalwiki/mediawiki-mcp-server で公開されています。Day 2 運用（ログ、/health／/ready、メトリクス、グレースフルシャットダウン）については、docs/operations.md を参照してください。

セキュリティ

デフォルト設定は、単一ユーザーでの利用において安全です。HTTP トランスポートを他のユーザーにも公開する前に、次の 3 点を必ず保護してください。

• リバースプロキシで TLS を終端してください。 信頼できないネットワーク上に MCP ポートを直接公開しないでください。docs/deployment.md — セキュリティチェックリストをご覧ください。
• MCP_BIND は MCP_ALLOWED_HOSTS および MCP_ALLOWED_ORIGINS と組み合わせてください。 HTTP トランスポートは、デフォルトで 127.0.0.1 にバインドされます。MCP_BIND=0.0.0.0 で公開する場合は、プロキシから転送されるホスト名を MCP_ALLOWED_HOSTS に、サーバーへの呼び出しを許可するブラウザーのオリジンを MCP_ALLOWED_ORIGINS に設定してください。これらは、それぞれ DNS リバインディング攻撃とクロスオリジン攻撃を防ぎます。
• アップロードはオプトインです。 upload-file は、許可するディレクトリを uploadDirs または MCP_UPLOAD_DIRS に指定するまで無効です。docs/configuration.md — アップロードディレクトリをご覧ください。
• 内部の宛先には MCP_TRUSTED_HOSTS が必要です。 外部へのフェッチは SSRF 対策で保護されています。プライベートアドレスまたはループバックアドレスに解決される宛先（mediawiki.svc のような Docker ネットワークのエイリアスなど）は、そのホストを MCP_TRUSTED_HOSTS に指定するまで拒否されます。docs/deployment.md — 外部への SSRF 対策をご覧ください。

脆弱性の報告には、GitHub のセキュリティアドバイザリーフォームをご利用ください。ポリシーの全文は SECURITY.md をご覧ください。

コントリビューション

コントリビューションを歓迎します。プルリクエストとイシュー（バグ、機能リクエスト、提案）のどちらも受け付けています。

• ツールのコードに取り組みますか？ リポジトリの構成、コマンド、テストのパターンについては、AGENTS.md をご覧ください。
• ツールの追加または変更を行いますか？ 説明文の文体、パラメーターのドキュメント、アノテーションのヒント、MediaWiki 用語の規約を説明している docs/tool-conventions.md をお読みください。
• リリースを行いますか？ docs/releasing.md をご覧ください。

ライセンス

このプロジェクトは MIT ライセンスのもとでライセンスされています。詳細は LICENSE ファイルをご覧ください。