wikijs-mcp

GraphQL API を通じて Wiki.js にアクセスするための MCP サーバー。FastMCP (Python) で構築されています。

公開されているツール

mail ドメインには manage:system 権限が必要です。 他のドメインとは異なり、mail の2つのツールは、Administrators グループ (権限 manage:system) に属する Wiki.js API キーでのみ使用できます。wikijs_mail_update_config も REPLACE-ALL です。1回の呼び出しでインスタンスのメール設定全体を上書きし、指定したフィールドだけを更新するわけではありません。

storage ドメインにも manage:system 権限が必要です。 storage の4つのツールは、Administrators グループに属する API キーでのみ使用できます。Force Sync (Admin → Storage のボタン) は wikijs_storage_action_execute(target_key="git", handler="sync") で実行します。wikijs_storage_target_list は資格情報に該当する設定値 (basicPassword、sshPrivateKeyContent) を *** にマスクします。実際の値は MCP 経由では読み取れません。ハンドラーはホワイトリスト化されていません。wikijs_storage_target_list の actions を使用して利用可能なハンドラーを見つけてください。また、その一部は破壊的であることに注意してください (purge はローカルの Git リポジトリを削除し、importAll はローカルのリポジトリから wiki のコンテンツをインポートします)。

wikijs_storage_target_update(target_key, is_enabled, mode, sync_interval, config) は 1つの ターゲットの設定を 部分更新 のセマンティクスで変更します。指定されていない引数は「変更しない」という意味であり、config はキーごとにマージされます。裏側の Wiki.js のミューテーション (storage.updateTargets) は実際には REPLACE-ALL であるため、ツールは指定されていないフィールドが削除されないように、独自に read-modify-write を実行します。ターゲットに存在しない config キーは拒否されます (ValueError)。また、"***" という値も拒否されます。これは wikijs_storage_target_list の編集用センチネルであり、実際の資格情報ではありません。

Related MCP server: mcp-wikijs-mv

設定

.env.example を .env にコピーし、適切な値を入力してください:

cp .env.example .env

必須変数

使用方法

stdio (Claude Desktop / VS Code)

{
  "mcpServers": {
    "wikijs": {
      "command": "uvx",
      "args": ["--from", "git+https://github.com/andhit-r/wikijs-mcp", "wikijs-mcp"],
      "env": {
        "WIKIJS_URL": "https://wiki.example.com",
        "WIKIJS_API_KEY": "your-api-key"
      }
    }
  }
}

HTTP + API Key (Claude Code / VS Code remote)

docker run -p 8000:8000 \
  -e WIKIJS_URL=https://wiki.example.com \
  -e WIKIJS_API_KEY=your-wikijs-api-key \
  -e MCP_API_KEY=your-mcp-api-key \
  ghcr.io/andhit-r/wikijs-mcp:latest

HTTP + Authentik OAuth (Claude Web)

.env に AUTHENTIK_* と MCP_BASE_URL のすべての変数を入力し、次に:

docker run -p 8000:8000 --env-file .env ghcr.io/andhit-r/wikijs-mcp:latest

ライセンス

MIT