Wiki.jsインスタンスをAIエージェントのナレッジベースとして活用できるMCPサーバー。
AIエージェントがウィキページの検索、閲覧、作成、更新、削除をWiki.js GraphQL API経由で実行できるようにブリッジする。
この記事はもともと必要な方々の助けになるようWiki.js公式Discussionsに投稿しましたが、不明な理由で削除されたため、ここに改めて記載します。
requarks-wiki-mcpは、Claude CodeやClaude DesktopなどのMCPクライアントからWiki.jsをナレッジベースとして活用できるように設計されたMCPサーバーです。
| 項目 | 値 |
|---|---|
| パッケージ名 | @yowu-dev/requarks-wiki-mcp |
| バージョン | v0.3.1 |
| ライセンス | MIT |
| Node.js | 20+ |
| 転送方式 | stdio (stdin/stdout) |
| GitHub | uyu423/requarks-wiki-mcp |
| npm | @yowu-dev/requarks-wiki-mcp |
Administration → API に移動Claude Codeで使用するには、~/.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 |
Yes | - | Wiki.jsベースURL |
WIKI_API_TOKEN |
Yes | - | Wiki.js APIキーJWT |
WIKI_GRAPHQL_PATH |
No | /graphql |
GraphQLエンドポイントパス |
WIKI_DEFAULT_LOCALE |
No | en |
デフォルトロケール |
WIKI_DEFAULT_EDITOR |
No | markdown |
デフォルトエディタ |
WIKI_MUTATIONS_ENABLED |
No | false |
書込ツール有効化 |
WIKI_MUTATION_CONFIRM_TOKEN |
No | (空) | 書込追加安全機構トークン |
WIKI_MUTATION_DRY_RUN |
No | true |
ドライランモード |
WIKI_ALLOWED_MUTATION_PATH_PREFIXES |
No | (空) | 書込許可パスプレフィックス |
WIKI_HTTP_TIMEOUT_MS |
No | 15000 |
HTTPタイムアウト (ms) |
WIKI_HTTP_MAX_RETRIES |
No | 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 |
IDでコメント取得 |
wikijs_get_system_info |
Wiki.jsバージョン、DB情報 |
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 |
タグのslug/title更新 |
wikijs_delete_tag |
全ページからタグ削除 |
意図しない書込を防止するための4段階安全機構:
WIKI_MUTATIONS_ENABLED=falseWIKI_MUTATION_CONFIRM_TOKEN設定時、一致するconfirm値が必要WIKI_ALLOWED_MUTATION_PATH_PREFIXESで書込可能パスを制限WIKI_MUTATION_DRY_RUN=trueでプレビューのみ返却全ての書込試行は構造化JSONでstderrに監査ログ出力。機密情報は自動的に[REDACTED]処理。
このサーバーは3つの内蔵リソースを提供します。LLMがこれらのリソースを読み取り、Wiki.jsのMarkdown構文やダイアグラム作成、権限の問題を自己解決できます。
| リソースURI | 説明 |
|---|---|
wikijs://markdown-guide |
Wiki.js Markdown構文ガイド（CommonMark/GFM + 拡張機能） |
wikijs://mermaid-guide |
Wiki.jsバンドルMermaid 8.8.2ダイアグラム構文ガイド（対応9種ダイアグラム、非対応機能の警告、バージョン制限事項） |
wikijs://api-permissions-guide |
API権限モデル、エラーコード、自己診断ガイド |
APIトークンはサーバー側でのみ保管し、クライアントに公開しないでください。
WIKI_MUTATIONS_ENABLED=falseを維持WIKI_ALLOWED_MUTATION_PATH_PREFIXESで書込範囲を最小化このMCPサーバーをより効果的に活用するには、自分の環境に合わせた独自のClaude Code Skillを作成して使用することを推奨します。
SkillサンプルはこのGistで確認できます。