将Wiki.js实例桥接为AI代理的知识库的MCP服务器。
AI代理可以通过Wiki.js GraphQL API搜索、查看、创建、更新和删除维基页面。
本文最初发布在Wiki.js官方Discussions上，旨在帮助有需要的人，但因不明原因被删除，因此在此重新发布。
requarks-wiki-mcp是一个MCP服务器，专为Claude Code或Claude Desktop等MCP客户端设计，使其能够将Wiki.js用作知识库。
| 项目 | 值 |
|---|---|
| 包名 | @yowu-dev/requarks-wiki-mcp |
| 版本 | v0.3.0 |
| 许可证 | MIT |
| Node.js | 20+ |
| 传输方式 | stdio (stdin/stdout) |
| GitHub | uyu423/requarks-wiki-mcp |
| npm | @yowu-dev/requarks-wiki-mcp |
在~/.claude.json的mcpServers字段中添加：
{
"mcpServers": {
"wikijs": {
"command": "npx",
"args": ["-y", "@yowu-dev/requarks-wiki-mcp@latest"],
"env": {
"WIKI_BASE_URL": "https://wiki.your-domain.dev",
"WIKI_API_TOKEN": "your_wikijs_api_key_jwt",
"WIKI_MUTATIONS_ENABLED": "true",
"WIKI_MUTATION_DRY_RUN": "false"
}
}
}
}
| 变量 | 必需 | 默认值 | 说明 |
|---|---|---|---|
WIKI_BASE_URL |
是 | - | Wiki.js基础URL |
WIKI_API_TOKEN |
是 | - | Wiki.js API密钥JWT |
WIKI_GRAPHQL_PATH |
否 | /graphql |
GraphQL端点路径 |
WIKI_DEFAULT_LOCALE |
否 | en |
默认语言 |
WIKI_DEFAULT_EDITOR |
否 | markdown |
默认编辑器 |
WIKI_MUTATIONS_ENABLED |
否 | false |
启用写入工具 |
WIKI_MUTATION_CONFIRM_TOKEN |
否 | (空) | 写入安全令牌 |
WIKI_MUTATION_DRY_RUN |
否 | true |
试运行模式 |
WIKI_ALLOWED_MUTATION_PATH_PREFIXES |
否 | (空) | 允许写入的路径前缀 |
WIKI_HTTP_TIMEOUT_MS |
否 | 15000 |
HTTP超时(ms) |
WIKI_HTTP_MAX_RETRIES |
否 | 2 |
读取失败最大重试次数 |
| 工具 | 说明 |
|---|---|
wikijs_search_pages |
全文搜索维基页面 |
wikijs_list_pages |
按语言和排序列出页面 |
wikijs_get_page_by_path |
按路径+语言获取页面 |
wikijs_get_page_by_id |
按ID获取页面 |
wikijs_get_page_tree |
浏览站点层次结构 |
wikijs_get_page_history |
查看编辑历史 |
wikijs_get_page_version |
获取特定版本 |
wikijs_get_page_links |
页面链接关系 |
| 工具 | 说明 |
|---|---|
wikijs_list_tags |
列出所有标签 |
wikijs_search_tags |
搜索标签 |
wikijs_list_comments |
列出页面评论 |
wikijs_get_comment |
获取单个评论 |
wikijs_get_system_info |
系统信息 |
wikijs_get_navigation |
导航树 |
wikijs_get_site_config |
站点配置 |
wikijs_list_assets |
资产列表 |
wikijs_list_asset_folders |
资产文件夹列表 |
wikijs_get_current_user |
当前用户 |
wikijs_search_users |
搜索用户 |
写入工具仅在
WIKI_MUTATIONS_ENABLED=true时启用。
| 工具 | 说明 |
|---|---|
wikijs_create_page |
创建新页面 |
wikijs_update_page |
更新页面 |
wikijs_delete_page |
删除页面 |
wikijs_move_page |
移动/重命名页面 |
wikijs_restore_page |
恢复到之前版本 |
wikijs_create_comment |
创建评论 |
wikijs_update_comment |
更新评论 |
wikijs_delete_comment |
删除评论 |
wikijs_update_tag |
更新标签 |
wikijs_delete_tag |
删除标签 |
防止意外写入的4层安全机制：
WIKI_MUTATIONS_ENABLED=falseWIKI_MUTATION_CONFIRM_TOKEN后需匹配WIKI_ALLOWED_MUTATION_PATH_PREFIXES限制可写路径WIKI_MUTATION_DRY_RUN=true仅返回预览所有写入尝试以JSON格式记录到stderr审计日志。敏感信息自动[REDACTED]处理。
API令牌仅在服务器端保存，不要暴露给客户端。
为了更有效地使用此MCP服务器，建议创建适合自己环境的Claude Code Skill。
Skill示例可在此Gist查看。