jaalbin24/wikijs-mcp
Developer toolsЭта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал
Сервер MCP предназначен для подключения кода Claude к экземпляру Wiki.js
Обзор
Сервер MCP, который соединяет MCP-клиенты с вашим экземпляром Wiki.js. Он поддерживает как локальные MCP-клиенты, так и удаленно размещенные клиенты. * Python 3.10+ * экземпляр Wiki.js с включенным доступом к API * ключ API Wiki.js (Администрация > Доступ к API > Новый ключ API) Ключ Wiki.js API используется только сервером MCP для связи с Wiki.js. Он остается и никогда не возвращается клиентам MCP. Многопользовательская авторизация Cloudflare Access для удаленного развертывания потокового HTTP: Сервер по умолчанию не связывается с 0.0.0.0. Для производства поставьте HTTPS/аутентификацию перед локальным HTTP-слушателем. Сервер намеренно связывается с 0.0.0.0 по умолчанию. Для удаленного развертывания рекомендуется поддерживать локальное прослушивание сервера MCP и выставлять его через обратный прокси HTTPS и, при необходимости, уровень аутентификации. Используйте stdio, когда клиент MCP может локально запустить сервер MCP.
Обзор (машинный перевод)
Сервер MCP, который соединяет MCP-клиенты с вашим экземпляром Wiki.js.
Он поддерживает как локальные соединения через stdio**, так и удаленные соединения с использованием официального MCP Streamable HTTP transport**, что делает его подходящим как для локальных клиентов MCP, так и для удаленно размещенных клиентов.
Предпосылки
Python 3.10+ Пример Wiki.js с включенным доступом к API Ключ Wiki.js API ([T0])
##Установка
Для местного развития:
Конфигурация
###Wiki.js
| Переменная | Дефолт | Описание
| WIKIJS_URL | требуется | Базовый URL вашего экземпляра Wiki.js |
| WIKIJS_API_KEY | требуется для режима stdio/single-key | Ключ API Legacy/default Wiki.js. Держал сервер на стороне и никогда не возвращался инструментами.
| WIKIJS_GRAPHQL_ENDPOINT | /graphql | Конечный путь Wiki.js GraphQL |
WIKIJS_READ_ONLY``false``true Когда true, инструменты мутации отключены.
| Переменная | Дефолт | Описание
| WIKIJS_URL | требуется | Базовый URL вашего экземпляра Wiki.js |
| WIKIJS_API_KEY | требуется | Ключ API Wiki.js |
[10][11][11][11][11][11]].
Эта страница переведена автоматически. Технические детали смотрите в оригинале.
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 |
Установка
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"
}
}
}
}