MMCPMarkets
HW

headz0r/wikijs-mcp-server

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

14 stars 9 forks Качество 62 Тренд 20MIT
Repository Install

Model Context Protocol (MCP) server for Wiki.js GraphQL API integration. Provides AI models with secure access to Wiki.js functionality through MCP protocol.

Обзор

Model Context Protocol (MCP) server for Wiki.js integration via GraphQL API. This project provides an MCP server for interacting with Wiki.js through GraphQL API. MCP (Model Context Protocol) is an open protocol developed by Anthropic that enables AI models to safely interact with external services and tools. The server provides a unified interface for working with Wiki.js that can be used by various AI agents and tools supporting MCP. - Get Wiki.js pages by ID - Get page content by ID - List pages with sorting options - Search pages by query - Create new pages - Update existing pages - Delete pages - - - - - - List users - Search users by query - Create new users - Update user information - : for editor integration (Cursor, VS Code) - : for web integrations and API access - Install dependencies - Create .env file based on example.env - Build TypeScript code 4. and replace your_wikijs_api_token_here with your real token

README

Показан фрагмент оригинального README. Открыть оригинал.

Wiki.js MCP Server

Model Context Protocol (MCP) server for Wiki.js integration via GraphQL API.

📖 Description

This project provides an MCP server for interacting with Wiki.js through GraphQL API. MCP (Model Context Protocol) is an open protocol developed by Anthropic that enables AI models to safely interact with external services and tools.

The server provides a unified interface for working with Wiki.js that can be used by various AI agents and tools supporting MCP.

✨ Features

📄 Page Management

  • Get Wiki.js pages by ID
  • Get page content by ID
  • List pages with sorting options
  • Search pages by query
  • Create new pages
  • Update existing pages
  • Delete pages
  • 🆕 List all pages including unpublished
  • 🆕 Search unpublished pages
  • 🆕 Force delete pages (including unpublished)
  • 🆕 Get page publication status
  • 🆕 Publish unpublished pages

👥 User Management

  • List users
  • Search users by query
  • Create new users
  • Update user information

🔧 Group Management

  • List user groups

🌐 Transports

  • STDIO: for editor integration (Cursor, VS Code)
  • HTTP: for web integrations and API access

🚀 Quick Start

⚡ Want to start right now? See 5-Minute Guide

Installation

  1. Clone the repository:
git clone https://github.com/heAdz0r/wikijs-mcp-server.git
cd wikijs-mcp-server
  1. Run automatic setup:
npm run setup

This script will automatically:

  • Install dependencies
  • Create .env file based on example.env
  • Build TypeScript code

Configuration

  1. Edit the .env file and specify your Wiki.js settings:
# Port for HTTP MCP server
PORT=3200

# Base URL for Wiki.js (without /graphql)
WIKIJS_BASE_URL=http://localhost:3000

# Wiki.js API token
WIKIJS_TOKEN=your_wikijs_api_token_here
  1. Edit the .cursor/mcp.json file and replace your_wikijs_api_token_here with your real token

How to get Wiki.js API token:

  1. Log into Wiki.js admin panel
  2. Go to “API” section
  3. Create a new API key with necessary permissions
  4. Copy the token to .env AND to .cursor/mcp.json

📦 Running

# Start main HTTP server with Cursor MCP support
npm start
# or
npm run start:http

# Stop server
npm run stop

TypeScript version

npm run start:typescript

STDIO mode (for direct editor integration)

npm run server:stdio

Development mode

npm run dev

Testing

npm test

🔌 Editor Integration

Cursor IDE

⚠️ IMPORTANT: Without .cursor/mcp.json file, Cursor integration will NOT work!

Quick Setup

  1. Start HTTP server:
npm start
  1. Automatic configuration setup:
Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "wikijs": { "transport": "http", "url": "http://localhost:3200/mcp", "events": "http://localhost:3200/mcp/events", "cwd": ".", "env": { "WIKIJS_BASE_URL": "http://localhost:3000", "WIKIJS_TOKEN": "your_real_wiki_js_token_here" } } } }