Wiki.js の統合には、包括的な Model Context Protocol (MCP) サーバ が、** 階層ドキュメント** サポートと Docker のデプロイメントに統合されています。 複数のリポジトリと大規模なドキュメントを管理する組織に最適です。

すぐにスタート

##1. 環境設定

まず、このリポジトリをクローンし、環境変数を設定します。

##2. Dockerデプロイメント(推奨)

Wiki.js は [http://localhost:3000 で利用できます。

ウェブインターフェイスで初期設定を完了

##3. MCPサーバーの設定

##4. Cursor MCPの設定 [~/.cursor/mcp.jsonに追加します。

欲求強化カーサーインテグレーション

ドキュメントファースト開発のグローバルルール

CursorでこのGlobal Rules を追加して、コーディング前にドキュメントを自動的に活用します。

これらのルールは、あなたのAIアシスタントが次のことを確実にします。

• ✅ 実装を提案する前にドキュメントをチェックする
• ✅ 既存のパターンと慣習に従う
• ✅ 最新のドキュメントを自動的に保持する
• ✅ 新しい機能のための構造化された文書を作成
• ✅ 既存の機能の重複を避けて下さい

Cursor の使用法のヒント

OST キー機能

📁階層ドキュメント

Wiki.js MCP Server

A comprehensive Model Context Protocol (MCP) server for Wiki.js integration with hierarchical documentation support and Docker deployment. Perfect for organizations managing multiple repositories and large-scale documentation.

🚀 Quick Start

1. Environment Setup

First, clone this repository and set up environment variables:

# Copy environment template
cp config/example.env .env

# Edit .env with your credentials:
# - Set POSTGRES_PASSWORD to a secure password
# - Update other settings as needed

2. Docker Deployment (Recommended)

# Start Wiki.js with Docker
docker-compose -f docker.yml up -d

Wiki.js will be available at http://localhost:3000

Complete the initial setup in the web interface

3. Setup MCP Server

# Install Python dependencies
./setup.sh

# Update .env with Wiki.js API credentials:
# - Get API key from Wiki.js admin panel  
# - Set WIKIJS_TOKEN in .env file

# Test the connection
./test-server.sh

# Start MCP server
# (not needed for AI IDEs like Cursor, simply click on the refresh icon after editing mcp.json
# and you should see a green dot with all tools listed. In existing open Cursor windows,
# this refresh is necessary in order to use this MCP)
./start-server.sh

4. Configure Cursor MCP

Add to your ~/.cursor/mcp.json:

{
  "mcpServers": {
    "wikijs": {
      "command": "/path/to/wiki-js-mcp/start-server.sh"
    }
  }
}

🎯 Enhanced Cursor Integration

Global Rules for Documentation-First Development

Add these Global Rules in Cursor to automatically leverage documentation before coding:

Before writing any code, always:
1. Search existing documentation using wikijs_search_pages to understand current patterns and architecture
2. Check for related components, functions, or modules that might already exist
3. If documentation exists for similar functionality, follow the established patterns and naming conventions
4. If no documentation exists, create it using wikijs_create_page or wikijs_create_nested_page before implementing
5. Always update documentation when making changes using wikijs_sync_file_docs
6. For new features, use wikijs_create_repo_structure to plan the documentation hierarchy first

These rules ensure that your AI assistant will:

• ✅ Check documentation before suggesting implementations
• ✅ Follow existing patterns and conventions
• ✅ Maintain up-to-date documentation automatically
• ✅ Create structured documentation for new features
• ✅ Avoid duplicating existing functionality

Usage Tips for Cursor

# Before starting a new feature
"Search the documentation for authentication patterns before implementing login"

# When creating components
"Create nested documentation under frontend-app/components before building the React component"

# For API development
"Check existing API documentation and create endpoint docs using the established structure"

# During refactoring