Wiki.js MCP 서버

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, ...)은 동일합니다. 이 저장소는 계속해서 수정 사항을 받으며, Claude Code 이외의 MCP 클라이언트에서 서버를 직접 실행하는 방법으로 유지됩니다(아래 빠른 시작 참조).

기존 설치 마이그레이션: ~/.claude/mcp-servers/wikijs/.env를 ~/.wikijs-plugin/.env로 복사하고(동일한 키, 동일한 값 — 새 API 토큰 불필요), 그런 다음 ~/.claude.json에서 기존 wikijs 항목을 제거하여 도구가 두 번 등록되지 않도록 하세요.

v2.0.0 - 주요 리팩토링

이 버전은 MCP 모범 사례를 따라 완전히 재작성되었습니다:

• TypeScript - 엄격 모드의 완전한 타입 안전성

• 최신 SDK - McpServer.tool() API와 함께 MCP SDK v1.24+ 사용

• Zod 검증 - 모든 도구에 대한 런타임 입력 검증

• 서비스 접두사 도구 - 모든 도구는 네임스페이스 명확성을 위해 wikijs_ 접두사를 사용합니다.

• 도구 주석 - 적절한 readOnlyHint, destructiveHint 등

• 페이지네이션 지원 - 목록 작업은 has_more, next_offset, total_count를 반환합니다.

• 문자 제한 - 큰 콘텐츠는 명확한 알림과 함께 잘립니다.

Related MCP server: mediawiki-mcp-server

문서

전체 문서 및 FAQ

포괄적인 가이드는 다음을 포함합니다:

• 설치 지침

• 구성 예제

• 매개변수가 포함된 모든 7개 MCP 도구

• GraphQL API 통합 세부 정보

• 문제 해결 가이드

빠른 시작

Claude Code 이외의 MCP 클라이언트의 경우(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)

• 페이지 관리 권한이 있는 Wiki.js API 토큰

사용 가능한 도구

개발

# 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

링크

• 전체 문서 (영어)

• 전체 문서 (독일어)

• 변경 로그