Wikijs MCP Server

🚀 WikiJS MCP Server

Wiki.jsのドキュメントにClaudeを接続しましょう！

このツールを使うと、Claudeが直接Wiki.jsのページを読み取り、更新することができます。チームの知識ベースにClaudeをアクセスさせることができ、ドキュメントの最新化や迅速な情報検索に最適です。

🎯 このツールの機能

インストール後、Claudeに以下のことを依頼できます。

• 🔍 特定のトピックを検索：ウィキ内で特定のトピックを検索します。
• 📖 ドキュメントページを読む：ドキュメントページを読み取ります。
• ✏️ 既存のページを更新：新しい情報で既存のページを更新します。
• 📝 新しいドキュメントを作成：新しいドキュメントを作成します。
• 🗂️ ページを整理：ページを移動して整理します。
• 🗑️ 古いページを削除：古いページを削除します。

🚀 インストールガイド

前提条件

インストールを開始する前に、以下がインストールされていることを確認してください。

• ✅ Git がインストールされていること (ここからダウンロード)
• ✅ Python 3.8以上 がインストールされていること (ここからダウンロード)
• ✅ Claude Code がインストールされていること (ここから入手)
• ✅ Wiki.jsサイトへのアクセス権 (APIキーが必要です。取得方法を説明します！)

ステップ1: コードをダウンロードする

ターミナル（Windowsの場合はコマンドプロンプト、Macの場合はターミナル）を開き、以下のコマンドを実行します。

git clone https://github.com/your-username/wikijs-mcp.git
cd wikijs-mcp

💡 ヒント：「command not found」エラーが表示された場合は、Gitがインストールされていることを確認してください！

ステップ2: Wiki.jsのAPIキーを取得する

1. Wiki.jsサイトに管理者としてログインします。
2. 管理画面（通常は上部メニューにあります）に移動します。
3. 左サイドバーの APIアクセス をクリックします。
4. APIが無効になっている場合は、トグルをクリックして 有効化 します。
5. "+ 新しいAPIキー" をクリックします。
6. 「Claude Integration」などの名前を付けます。
7. 以下の権限を選択します。
   • ✅ ページを読む
   • ✅ ページを書く
   • ✅ ページを管理する（Claudeにページの作成/削除を許可する場合）
8. 作成 をクリックし、APIキーをコピー します。次のステップで必要になります！

⚠️ 重要：このキーを安全な場所に保存してください。再度表示することはできません！

ステップ3: 接続を設定する

1. 設定ファイルを作成します。

   cp .env.example .env
   

2. .envファイルを任意のテキストエディタで開きます（メモ帳、TextEdit、VS Codeなど）。

3. サンプル値を実際の情報に置き換えます。

   WIKIJS_URL=https://your-wiki-site.com
   WIKIJS_API_KEY=paste-your-api-key-here
   

   📌 例：

   WIKIJS_URL=https://docs.mycompany.com
   WIKIJS_API_KEY=ey1234567890abcdef...
   

ステップ4: Pythonの依存関係をインストールする

以下のコマンドを実行して、ツールが必要とする依存関係をインストールします。

pip install -e .

💡 トラブルシューティング：

• "pip: command not found" エラーが表示された場合は、pip3 を試してみてください。
• Macの場合は、python3 -m pip install -e . を使用する必要がある場合があります。

ステップ5: 接続をテストする

すべてが正常に動作することを確認しましょう。以下のコマンドを実行します。

python -m wikijs_mcp.server

以下のような出力が表示されるはずです。

WikiJS MCP Server starting...
Connected to Wiki.js at https://your-wiki-site.com
Ready to accept connections!

Ctrl+C を押して停止します。

🎉 Claude Codeでの使用方法

最高の部分は、Claude Codeが自動的にこのMCPサーバーを検出することです！

リポジトリには特別な .mcp.json ファイルが含まれており、Claude Codeが自動的に読み取ります。以下の手順を実行するだけです。

1. wikijs-mcp フォルダで Claude Codeを開きます。
2. Claudeが自動的にWiki.jsにアクセスできるようになります！

試してみるコマンド

接続後、Claudeに以下のようなことを依頼できます。

"Search my wiki for information about deployment procedures"
"Read the page at /docs/getting-started"
"Update the troubleshooting guide with a new solution for login issues"
"Create a new page at /docs/api/webhooks with webhook documentation"

🔧 手動設定（上級者向け）

別のMCPクライアントを使用している場合や、カスタム設定が必要な場合は、以下の設定を行います。

標準インストールの場合

{
  "mcpServers": {
    "wikijs": {
      "command": "python",
      "args": ["-m", "wikijs_mcp.server"],
      "env": {
        "WIKIJS_URL": "https://your-wiki-site.com",
        "WIKIJS_API_KEY": "your-api-key"
      }
    }
  }
}

Dockerユーザーの場合

{
  "mcpServers": {
    "wikijs": {
      "command": "docker",
      "args": ["compose", "run", "--rm", "-T", "wikijs-mcp-server", "python3", "-m", "wikijs_mcp.server"],
      "cwd": "/path/to/wikijs-mcp"
    }
  }
}

🆘 一般的な問題と解決策

"Connection refused" または "Cannot connect to Wiki.js"

• ✅ WIKIJS_URL に末尾のスラッシュがないことを確認してください。
• ✅ Wiki.jsサイトがコンピューターからアクセス可能であることを確認してください。
• ✅ Wiki.jsの管理パネルでAPIが有効になっていることを確認してください。

"Authentication failed" または "Invalid API key"

• ✅ APIキー全体を正しくコピーしたことを再確認してください。
• ✅ キーの前後に余分なスペースがないことを確認してください。
• ✅ APIキーに適切な権限があることを確認してください。

"Module not found" エラー

• ✅ wikijs-mcp フォルダで pip install -e . を実行したことを確認してください。
• ✅ python の代わりに python3 を使用してみてください。

Claude CodeがWiki.jsのツールを認識しない場合

• ✅ wikijs-mcp フォルダからClaude Codeを実行していることを確認してください。
• ✅ .mcp.json ファイルが存在することを確認してください。
• ✅ Claude Codeを再起動してみてください。

📚 利用可能なツールのリファレンス

接続後、Claudeが実行できることは以下の通りです。

🛠️ 開発者向け情報

テストの実行

# 開発用依存関係をインストールする
pip install -e ".[dev]"

# すべてのテストを実行する
pytest

# カバレッジを含めて実行する
pytest --cov=wikijs_mcp

コード品質

# コードを整形する
black wikijs_mcp/ tests/

# 型チェックを行う
mypy wikijs_mcp/

📄 ライセンス

MITライセンスです。自由に使用し、変更してください！

💬 ヘルプが必要ですか？

• 上記の 一般的な問題と解決策 セクションを確認してください。
• Wiki.jsのドキュメント を参照してください。
• 困った場合は、GitHubでissueを作成してください！

快適なドキュメント作成を！ 🎉