headz0r/wikijs-mcp-server

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

14 stars 9 forks 품질 62 트렌드 20MIT

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

Clone the repository:

git clone https://github.com/heAdz0r/wikijs-mcp-server.git
cd wikijs-mcp-server

Run automatic setup:

npm run setup

This script will automatically:

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

Configuration

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

Edit the .cursor/mcp.json file and replace your_wikijs_api_token_here with your real token

How to get Wiki.js API token:

Log into Wiki.js admin panel

Go to “API” section

Create a new API key with necessary permissions

Copy the token to .env AND to .cursor/mcp.json

📦 Running

HTTP server (recommended)

# 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

Start HTTP server:

npm start

Automatic configuration setup:

GitHub에서 전체 README 보기

설치

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"
      }
    }
  }
}