Wikijs Mcp について
Wikijs Mcpは、AIアシスタントをWiki.jsインスタンスに接続し、コンテンツの検索と取得を可能にします。ID、パス、ロケールでページを取得したり、全ページを一覧表示したりでき、stdioとstreamable HTTPに対応します。
主な機能
- 01クエリによるページ検索
- 02IDによるページ取得
- 03パスとロケールによるページ取得
- 04全Wikiページの一覧表示
- 05stdioまたはstreamable HTTPに対応
活用シーン
- 01トピックに関するWikiページを探す
- 02ページIDで内容を取得する
- 03パスを指定してローカライズ済みページを取得する
- 04streamable HTTPで接続する
MCP 対応
このMCPサーバーは、Wiki.jsの検索とページ取得のツールをAIクライアントに提供します。stdioとstreamable HTTPのトランスポートに対応します。
設定
ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。
ツール
4掲載時のツール一覧 · 2 週間前に更新
| パラメーター | 型 | 必須 | 説明 |
|---|---|---|---|
| locale | string | いいえ | 検索時に指定する任意のロケール(例:"en") |
| path | string | いいえ | 検索範囲を限定する任意のパス |
| query | string | はい | ページを検索するクエリ |
詳細
WikiJS MCP サーバー
WikiJS と統合し、AI アシスタントが WikiJS のナレッジベースからコンテンツを検索、取得できるようにする Model Context Protocol(MCP)サーバーです。
概要
この MCP サーバーは、次のツールを提供することで、AI アシスタントが WikiJS インスタンスを操作できるようにします。
- クエリ文字列でページを検索
- ID でページを取得
- パスとロケールでページを取得
- Wiki のすべてのページを取得
Cursor の設定
Stdio
{
"mcpServers": {
"wikijs-mcp": {
"command": "npx",
"args": [
"wikijs-mcp"
],
"env": {
"WIKIJS_URL": <your wikijs url>,
"WIKIJS_API_KEY": <your wikijs api key>
}
}
}
}
Streamable Http
ホストマシン
サーバーを起動します。TRANSPORT_METHOD=streamable-http TRANSPORT_OPTIONS_PORT=8080 npx wikijs-mcp(使用できるすべての変数については、環境変数を参照してください)
IDE
{
"mcpServers": {
"wikijs-mcp": {
"transport": "http-streamable",
"name": "WikiJS MCP",
"url": <your mcp host url with port>/mcp
}
}
}
WikiJS API キーの取得
- 管理者として WikiJS インスタンスにログインします
- Administration > API Access に移動します
- 適切な権限を付与した新しい API キーを作成します
- 生成されたキーを
.envファイルにコピーします
開発
- リポジトリをクローンします。
git clone https://github.com/RicardoCenci/wikijs-mcp.git
cd wikijs-mcp
- 依存関係をインストールします。
npm install
- 環境テンプレートをコピーし、内容を入力します。
cp env.example .env
- プロジェクトをビルドします。
makeがインストールされている場合:
make build
- テスト用に WikiJS インスタンスをデプロイします。
docker compose up -d
使用方法
npx wikijs-mcp
環境変数
| 変数 | 説明 | 必須 | 使用可能な値 | デフォルト |
|---|---|---|---|---|
WIKIJS_URL | WikiJS インスタンスの URL | はい | - | - |
WIKIJS_API_KEY | WikiJS API キー | はい | - | - |
TRANSPORT_METHOD | トランスポート方式 | いいえ | stdio, streamable-http | stdio |
TRANSPORT_OPTIONS_CORS_ORIGIN | CORS オリジン(streamable-http の場合のみ) | いいえ | - | * |
TRANSPORT_OPTIONS_CORS_HEADERS | CORS ヘッダー、カンマ区切り(streamable-http の場合のみ) | いいえ | - | Content-Type=mcp-session-id |
TRANSPORT_OPTIONS_CORS_METHODS | CORS メソッド、カンマ区切り(streamable-http の場合のみ) | いいえ | - | GET,POST,OPTIONS |
TRANSPORT_OPTIONS_SESSION_TIMEOUT_MS | セッションタイムアウト(streamable-http の場合のみ) | いいえ | - | 60000 |
ライセンス
このプロジェクトは MIT ライセンスの下でライセンスされています。
コメント
Markdown 対応
AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。