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
"Update all related documentation pages for the files I'm about to modify"

🚀 Key Features

📁 Hierarchical Documentation

• Repository-level organization: Create structured docs for multiple repos
• Nested page creation: Automatic parent-child relationships
• Auto-organization: Smart categorization by file type (components, API, utils, etc.)
• Enterprise scalability: Handle hundreds of repos and thousands of files

🔧 Core Functionality

• GraphQL API integration: Full Wiki.js v2+ compatibility
• File-to-page mapping: Automatic linking between source code and documentation
• Code structure analysis: Extract classes, functions, and dependencies
• Bulk operations: Update multiple pages simultaneously
• Change tracking: Monitor file modifications and sync docs

🐳 Docker Setup

• One-command deployment: Complete Wiki.js setup with PostgreSQL
• Persistent storage: Data survives container restarts
• Health checks: Automatic service mo

... View full README on GitHub