Skip to main content
Glama

wikijs-mcp

用于通过 GraphQL API 访问 Wiki.js 的 MCP 服务器,基于 FastMCP(Python)构建。

暴露的工具

域

工具

pages

wikijs_page_list、wikijs_page_get、wikijs_page_get_by_path、wikijs_page_create、wikijs_page_update、wikijs_page_delete、wikijs_page_move、wikijs_page_render、wikijs_page_tree

search

wikijs_page_search

tags

wikijs_tag_list、wikijs_page_list_by_tags

groups

wikijs_group_list、wikijs_group_get、wikijs_group_create、wikijs_group_update、wikijs_group_delete、wikijs_group_assign_user、wikijs_group_unassign_user

users

wikijs_user_list、wikijs_user_get、wikijs_user_create、wikijs_user_update、wikijs_user_delete、wikijs_user_activate、wikijs_user_deactivate、wikijs_user_enable_tfa、wikijs_user_disable_tfa

system

wikijs_system_info

mail

wikijs_mail_update_config、wikijs_mail_send_test

storage

wikijs_storage_target_list、wikijs_storage_status、wikijs_storage_action_execute、wikijs_storage_target_update

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

必需变量

变量

说明

WIKIJS_URL

Wiki.js 实例的基础 URL,例如 https://wiki.example.com

WIKIJS_API_KEY

Wiki.js API key(Admin → API Access)

使用方法

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers