wikijs-mcp

用于通过 GraphQL API 访问 Wiki.js 的 MCP 服务器，基于 FastMCP（Python）构建。

暴露的工具

mail 域要求 manage:system 权限。 与其他域不同，这两个 mail 工具只能使用属于 Administrators 组（拥有 manage:system 权限）的 Wiki.js API key 来调用。wikijs_mail_update_config 也是 REPLACE-ALL 语义——一次调用会覆盖实例的整个邮件配置，而不仅仅是所提到的字段。

storage 域同样要求 manage:system 权限。 这四个 storage 工具只能使用属于 Administrators 组的 API key 来调用。Force Sync（Admin → Storage 中的按钮）通过 wikijs_storage_action_execute(target_key="git", handler="sync") 执行。wikijs_storage_target_list 会将属于凭据性质的配置值（basicPassword、sshPrivateKeyContent）打码为 ***——原始值无法通过 MCP 读取。handler 不做白名单限制：请使用 wikijs_storage_target_list 返回的 actions 来查找可用的 handler，并注意其中一些具有破坏性（purge 会删除本地 Git 仓库，importAll 会用本地仓库的内容覆盖 wiki 内容）。

wikijs_storage_target_update(target_key, is_enabled, mode, sync_interval, config) 以 部分更新 语义修改 一个 目标的配置：未填写的参数表示“不要更改”，config 按 key 合并。其背后的 Wiki.js mutation（storage.updateTargets）实际上是 REPLACE-ALL，因此该工具自行执行 read-modify-write，以确保未提及的字段不会被删除。目标上尚不存在的 config key 会被拒绝（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