WikiJS MCP Server

WikiJS MCP Server

A Model Context Protocol (MCP) server for managing WikiJS instances. This server provides read and write capabilities for wiki pages, including search, creation, updates, deletion, and knowledge graph exploration.

Important: This is an MCP server without OAuth authentication, designed for trusted environments where the server runs with pre-configured API credentials.

Features

Tools (15 Total)

Read Operations (12 tools):

• list_wiki_pages - List all pages in the wiki
• get_wiki_page - Get a specific page by ID
• get_page_by_path - Get a page by its path
• search_wiki_pages - Search pages by keyword
• get_page_history - Get revision history for a page
• get_recent_changes - Get recently modified pages
• list_page_tags - List all tags used in the wiki
• search_by_tag - Find pages by tag
• find_related_pages - Discover related content
• explore_knowledge_graph - Navigate tag-based knowledge graphs
• create_page_summary - Generate summaries of page content
• export_page_content - Export page in markdown, HTML, or plain text
• get_wiki_stats - Get wiki statistics

Write Operations (3 tools):

• create_wiki_page - Create new wiki pages
• update_wiki_page - Update existing pages by ID or path
• delete_wiki_page - Delete pages with confirmation protection

Prompts (5 Total)

• new_page_template - Template for creating new wiki pages
• documentation_review - Guide for reviewing documentation
• faq_generator - Template for FAQ generation
• knowledge_explorer - Explore connections between pages
• search_guide - Help users search effectively

Resources (5 Total)

• wiki://pages - List of all pages
• wiki://page/{id} - Specific page content by ID
• wiki://tags - All available tags
• wiki://recent-changes - Recent modifications
• wiki://stats - Wiki statistics

Prerequisites

• Node.js 18+
• A WikiJS instance with API access enabled
• API key from your WikiJS admin panel (Administration > API)

Quick Start

Local Development

1. Clone the repository:

git clone https://github.com/vnikhilbuddhavarapu/wiki-mcp.git
cd wiki-mcp

2. Install dependencies:

npm install

3. Configure environment variables:

cp .dev.vars.example .dev.vars

Edit .dev.vars with your WikiJS credentials:

WIKI_JS_BASE_URL=https://your-wiki-instance.com
WIKI_JS_API_KEY=your-api-key-here

4. Run locally:

npm run dev

Deploy to Cloudflare Workers

1. Click the deploy button above or run:

npm run deploy

2. Set your secrets:

npx wrangler secret put WIKI_JS_BASE_URL
npx wrangler secret put WIKI_JS_API_KEY

Configuration

Environment Variables

Path Format

Page paths are automatically normalized:

• Input: my-page, /my-page, //my-page/, my-page/
• Normalized: /my-page

Usage with MCP Clients

Claude Desktop

Add to your Claude Desktop configuration (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "wikijs": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://wiki-mcp.your-account.workers.dev/mcp"],
      "env": {
        "WIKI_JS_BASE_URL": "https://your-wiki-instance.com",
        "WIKI_JS_API_KEY": "your-api-key-here"
      }
    }
  }
}

Other MCP Clients

Connect to the mcp endpoint:

https://your-worker.your-account.workers.dev/mcp

Project Structure

src/
├── index.ts                 # Main MCP server setup and initialization
├── wikijs-client.ts         # GraphQL client for WikiJS API
├── shared/
│   └── utils.ts            # Logging utilities and path sanitization
├── tools/                   # MCP tool implementations
│   ├── create-page.ts
│   ├── delete-page.ts
│   ├── update-page.ts
│   ├── search-pages.ts
│   ├── list-pages.ts
│   ├── get-page.ts
│   ├── get-page-by-path.ts
│   ├── page-history.ts
│   ├── recent-changes.ts
│   ├── list-tags.ts
│   ├── search-by-tag.ts
│   ├── find-related-pages.ts
│   ├── explore-knowledge-graph.ts
│   ├── create-summary.ts
│   ├── export-page.ts
│   ├── wiki-stats.ts
│   └── index.ts            # Tool exports
├── prompts/                # MCP prompt templates
│   ├── new-page-template.ts
│   ├── documentation-review.ts
│   ├── faq-generator.ts
│   ├── knowledge-explorer.ts
│   ├── search-guide.ts
│   └── index.ts            # Prompt exports
└── resources/              # MCP resources
    ├── page-by-id.ts
    ├── pages-list.ts
    ├── tags-list.ts
    ├── recent-changes.ts
    ├── stats.ts
    └── index.ts