wikijs-graphql-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WIKIJS_LOCALE | No | The default locale used when a tool does not specify a locale. Defaults to zh-tw. | zh-tw |
| WIKIJS_BASE_URL | Yes | The Wiki.js site URL, for example https://wiki.example.com. Do not append /graphql; a subpath may be included if Wiki.js is hosted there. Production sites must use HTTPS; HTTP is only allowed for loopback local testing. | |
| WIKIJS_API_TOKEN | Yes | The Wiki.js API key created under Admin → API Access. It is sent as an Authorization: Bearer token. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
唯讀 Wiki.js MCP(https://wiki.example.com,預設語系 zh-tw)。先用 wikijs_search_pages 或 wikijs_browse_tree 找到頁面路徑,再用 wikijs_get_page 讀取內容。此 server 不提供任何建立、更新或刪除能力。
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| wikijs_search_pagesA | 以關鍵字搜尋 Wiki.js 頁面(使用站台設定的搜尋引擎),回傳標題、描述與路徑(不含頁面 ID,因站台搜尋索引的 ID 可能與實際頁面不一致)。可用 pathPrefix 限定路徑範圍;取得路徑後再以 wikijs_get_page 讀取全文。 |
| wikijs_get_pageA | 依頁面路徑讀取 Wiki.js 頁面的 Markdown 原始內容與中繼資料。path 不含 .md,可含中文,例如 RD部/Projects/Foo;也可直接貼上同站台的頁面網址。長頁面可用 maxChars 與 contentOffset 分段讀取。 |
| wikijs_get_page_by_idA | 依頁面 ID 讀取 Wiki.js 頁面的 Markdown 原始內容與中繼資料(ID 可由搜尋、列表或頁面樹取得)。 |
| wikijs_list_pagesA | 列出 Wiki.js 頁面的中繼資料(不含內容),可依路徑前綴、標籤與語系篩選並排序,例如查看某目錄下最近更新的頁面。 |
| wikijs_browse_treeA | 瀏覽 Wiki.js 的目錄結構:省略 path 時列出根層,指定 path 時列出該目錄的直接子項目(資料夾與頁面)。 |
| wikijs_list_tagsA | 列出 Wiki.js 上所有頁面標籤,可搭配 wikijs_list_pages 的 tags 篩選。 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
Each tool has a reasonably distinct role, but list_pages, search_pages, and browse_tree all enumerate pages and their boundaries depend on the descriptions rather than the names. The get_page vs get_page_by_id pair is only distinguished by path-vs-ID, which is clear enough once read but easy to misselect at a glance.
Every tool carries the wikijs_ prefix and a verb_noun form (search_pages, list_pages, list_tags, get_page, get_page_by_id), so the set reads predictably. Minor deviations: browse_tree uses a different verb style, and get_page/get_page_by_id are near-duplicates in name shape.
Six tools is well within the ideal range and each covers a distinct read path (search, fetch by id, fetch by path, list metadata, tree browse, tags). Nothing feels padded or redundant.
The surface is entirely read-only — there is no create, update, move, or delete page operation, so any agent asked to author or maintain wiki content will hit a dead end. Tag listing without any tag-mutation or page-write tool reinforces that this is a partial lifecycle.