MCP WikiJS

An MCP (Model Context Protocol) server for WikiJS that allows AI models to interact with wiki content.

Features

• An MCP server exposing WikiJS as tools (stdio transport; no MCP resources/prompts yet)
• Built with TypeScript for type safety and modern JavaScript features
• Simple to use - can be started with a single npx command
• Provides AI models with access to WikiJS content through MCP tools:
  • Search documents
  • Read document content
  • Create new documents
  • Update existing documents
  • Delete documents
• Docker-ready for easy development setup

Installation

Using npx (once published to npm)

No local clone or build required. Add this to your MCP client config (e.g. Claude Desktop/Code):

{
  "mcpServers": {
    "wikijs": {
      "command": "npx",
      "args": ["-y", "@im-neko/mcp-wikijs"],
      "env": {
        "WIKIJS_URL": "https://example.com",
        "WIKIJS_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

From source (current development install)

git clone https://github.com/Im-neko/mcp-wikijs.git
cd mcp-wikijs
npm install
npm run build

{
  "mcpServers": {
    "wikijs": {
      "command": "node",
      "args": ["path/to/mcp-wikijs/dist/index.js"],
      "env": {
        "WIKIJS_URL": "https://example.com",
        "WIKIJS_TOKEN": "YOUR_API_TOKEN"
      }
    }
  }
}

Docker Development Environment

For development purposes, this project includes a Docker Compose setup that starts:

• A PostgreSQL database
• A WikiJS instance
• The MCP-WikiJS server with hot-reload

To start the development environment:

docker-compose up

For detailed instructions, see the Docker guide.

Available Tools

• search - Search for wiki pages by query
• read - Read a wiki page by ID or path
• create - Create a new wiki page
• update - Update an existing wiki page
• delete - Delete a wiki page by ID

Examples

See the examples directory for detailed usage examples, including:

• Integrating with chat applications
• Document search and retrieval
• Content creation and management

Configuration

WikiJS Configuration

• WIKIJS_URL: URL of your WikiJS instance
• WIKIJS_TOKEN: API token for authentication with WikiJS

Logging

• LOG_LEVEL: Logging level (debug, info, warn, error; default: info)

The server communicates with its MCP client over stdio only; there is no HTTP transport or port to configure.

Development

See Installation > From source to build locally. To inspect the server interactively:

npx @modelcontextprotocol/inspector node dist/index.js

Docker Development

See the Docker guide for instructions on setting up a complete development environment with Docker.

Project Documentation

• Architecture Document - Detailed design of the system
• Implementation Plan - Development phases and schedule
• Docker Guide - Development with Docker

Architecture

This project follows a modular architecture with clear separation of concerns:

• Configuration management: Environment variables and settings
• WikiJS client: Handles communication with WikiJS GraphQL API
• MCP server: Implements the Model Context Protocol
• Tools: Implements specific operations (search, read, update, etc.)

License

MIT