Wiki.js MCP Server

Model Context Protocol Server для интеграции с Wiki.js — создавайте и управляйте вики-страницами прямо из вашего AI-ассистента.

Используете это из Claude Code? Воспользуйтесь wikijs-plugin — он объединяет этот сервер (портированный на Python) с навыком docs-wiki в единый плагин, устанавливаемый через механизм маркетплейса Claude Code, без ручных шагов по клонированию, сборке и настройке. Конфигурация перемещается из .env этого репозитория в ~/.wikijs-plugin/.env (настраивается через /wikijs-plugin:setup); среда выполнения меняется с Node.js 18+ на Python 3.11+; имена инструментов (wikijs_create_page, ...) остаются без изменений. Этот репозиторий продолжает получать исправления и остаётся способом запуска сервера напрямую (см. Quick Start ниже) для любого MCP-клиента, кроме Claude Code.

Миграция существующей установки: скопируйте ~/.claude/mcp-servers/wikijs/.env в ~/.wikijs-plugin/.env (те же ключи, те же значения — новый токен API не требуется), затем удалите старую запись wikijs из ~/.claude.json, чтобы инструменты не регистрировались дважды.

v2.0.0 — Крупный рефакторинг

Эта версия включает полную переработку в соответствии с лучшими практиками MCP:

• TypeScript — Полная типобезопасность со строгим режимом

• Современный SDK — Использует MCP SDK v1.24+ с API McpServer.tool()

• Валидация Zod — Проверка входных данных во время выполнения для всех инструментов

• Инструменты с префиксом сервиса — Все инструменты используют префикс wikijs_ для ясности пространства имён

• Аннотации инструментов — Правильные readOnlyHint, destructiveHint и т.д.

• Поддержка пагинации — Операции списка возвращают has_more, next_offset, total_count

• Ограничения по символам — Большой контент обрезается с чёткими уведомлениями

Related MCP server: mediawiki-mcp-server

Документация

Полная документация и FAQ

Подробное руководство включает:

• Инструкции по установке

• Примеры конфигурации

• Все 7 инструментов MCP с параметрами

• Детали интеграции GraphQL API

• Руководство по устранению неполадок

Быстрый старт

Для любого MCP-клиента, кроме Claude Code (см. примечание выше для Claude Code):

# 1. Clone repository
git clone https://github.com/markus-michalski/wikijs-mcp-server.git
cd wikijs-mcp-server

# 2. Install dependencies
npm install

# 3. Build TypeScript
npm run build

# 4. Configure environment
cp .env.example .env
# Edit .env with your Wiki.js API credentials

# 5. Point your MCP client's config at dist/index.js and restart it

Требования

• Node.js 18+

• Экземпляр Wiki.js (v2.x или v3.x)

• Токен API Wiki.js с правами управления страницами

Доступные инструменты

Разработка

# Development with hot-reload
npm run dev

# Build for production
npm run build

# Type checking
npm run typecheck

Структура проекта

wikijs-mcp-server/
├── src/
│   ├── index.ts           # Main server entry point
│   ├── constants.ts       # Shared constants (CHARACTER_LIMIT, etc.)
│   ├── types.ts           # TypeScript type definitions
│   ├── schemas/           # Zod validation schemas
│   ├── services/          # API client and error handling
│   └── tools/             # Tool implementations
├── dist/                  # Compiled JavaScript
├── evaluation.xml         # MCP evaluation test questions
└── package.json

Лицензия

Лицензия MIT — см. LICENSE для подробностей

Автор

Markus Michalski

• Сайт: markus-michalski.net

• GitHub: @markus-michalski

Ссылки

• Полная документация (английский)

• Полная документация (немецкий)

• Журнал изменений