JW

jaalbin24/wikijs-mcp

Developer tools

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

19 stars 12 forks 품질 70 트렌드 36

MCP 서버는 Claude Code를 Wiki.js 인스턴스에 연결하도록 설계되었습니다

개요

MCP 클라이언트를 Wiki.js 인스턴스에 연결하는 MCP 서버. 그것은 둘 다 지원하고, 국부적으로 MCP 클라이언트 뿐 아니라 원격으로 호스팅한 클라이언트를 위해 적당한 만들기. * Python 3.10+ * API 액세스 활성화를 가진 Wiki.js 인스턴스 * Wiki.js API 키 (Administration > API 액세스 > 새로운 API 키) Wiki.js API 키는 MCP 서버가 Wiki.js와 통신하도록만 사용됩니다. 그것은 남아 있고 MCP 클라이언트에 반환하거나 노출되지 않습니다. Cloudflare 액세스 멀티 사용자 인증, 원격 스트리밍 HTTP 배포 : 서버는 기본적으로 0.0.0.0에 바인딩하지 않습니다. 생산의 경우, 로컬 HTTP 리스너 앞에 HTTPS/authentication를 넣어. 서버는 의도적으로 기본적으로 0.0.0.0에 바인딩합니다. 원격 배포의 경우, 권장 설정은 로컬로 듣는 MCP 서버를 유지하고 HTTPS 역 프록시를 통해 노출하고 적절한 인증 층을 때. MCP 클라이언트가 로컬로 MCP 서버를 시작할 수 있을 때 stdio를 사용하십시오.

개요(AI 번역)

MCP 클라이언트를 Wiki.js 인스턴스에 연결하는 MCP 서버.

그것은 stdio **에 대한 ** 로컬 연결을 지원하고 ** 공식 MCP Streamable HTTP 운송을 사용하여 **, 로컬 MCP 클라이언트뿐만 아니라 원격 호스팅 클라이언트에 적합합니다.

필수품

  • 파이썬 3.10+
  • API 액세스 활성화를 가진 Wiki.js 인스턴스
  • Wiki.js API 키 ([T0]])

설치

현지 개발:

구성

위키.js

변수 기본 설명
WIKIJS_URL 필수 Wiki.js의 기본 URL
WIKIJS_API_KEY stdio/single-key 모드 필요 레거시/기본 Wiki.js API 키. Kept 서버 측과 결코 도구로 반환하지
[T3] [T4] Wiki.js GraphQL 엔드포인트 경로
WIKIJS_READ_ONLY false 언제 [T7]], mutation tools are disabled
변수 기본 설명
인포메이션 센터
[T8] 필수 Wiki.js의 기본 URL
[T9] 필수 Wiki.js API 키
[T10] 【T11】 한국어.

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

README

원문 README의 일부입니다. 원문 보기.

WikiJS MCP Server

An MCP server that connects MCP clients to your Wiki.js instance.

It supports both local connections over stdio and remote connections using the official MCP Streamable HTTP transport, making it suitable for local MCP clients as well as remotely hosted clients.

Prerequisites

  • Python 3.10+
  • A Wiki.js instance with API access enabled
  • A Wiki.js API key (Administration > API Access > New API Key)

Installation

pip install wikijs-mcp

For local development:

git clone https://github.com/Ho3pLi/wikijs-mcp-http.git
cd wikijs-mcp-http
pip install -e .

Configuration

Wiki.js

Variable Default Description
WIKIJS_URL required Base URL of your Wiki.js instance
WIKIJS_API_KEY required for stdio/single-key mode Legacy/default Wiki.js API key. Kept server-side and never returned by tools
WIKIJS_GRAPHQL_ENDPOINT /graphql Wiki.js GraphQL endpoint path
WIKIJS_READ_ONLY false When true, mutation tools are disabled
Variable Default Description
------------------------- ---------- ----------------------------------------
WIKIJS_URL required Base URL of your Wiki.js instance
WIKIJS_API_KEY required Wiki.js API key
WIKIJS_GRAPHQL_ENDPOINT /graphql Wiki.js GraphQL endpoint path
WIKIJS_READ_ONLY false When true, mutation tools are disabled

The Wiki.js API key is used only by the MCP server to communicate with Wiki.js. It remains server-side and is never returned or exposed to MCP clients.

Streamable HTTP

Variable Default Description
MCP_HOST 127.0.0.1 Host interface for HTTP mode
MCP_PORT 8000 Port for HTTP mode
MCP_PATH /mcp MCP Streamable HTTP endpoint path
MCP_ALLOWED_HOSTS 127.0.0.1:*,localhost:* Comma-separated Host header allowlist
MCP_ALLOWED_ORIGINS http://127.0.0.1:*,http://localhost:* Comma-separated Origin header allowlist

Cloudflare Access multi-user authorization, for remote Streamable HTTP deployments:

Variable Default Description
WIKIJS_CF_ACCESS_ISSUER unset Cloudflare Access JWT issuer, usually https://.cloudflareaccess.com
WIKIJS_CF_ACCESS_AUDIENCE unset Cloudflare Access application audience tag
GitHub에서 전체 README 보기

설치

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

Open the repository installation guide MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "wikijs": { "command": "pipx", "args": ["run", "wikijs-mcp"], "env": { "WIKIJS_URL": "https://your-wiki.com", "WIKIJS_API_KEY": "your-api-key" } } } }