GROWI MCP Server

GROWI WikiにAIモデルを接続するためのModel Context Protocol (MCP) HTTPサーバー。Bearer認証に対応。

機能

ページ操作

• getPage - ページ内容の取得
• getPageInfo - ページ情報の取得
• createPage - ページの作成
• updatePage - ページの更新
• deletePage - ページの削除
• duplicatePage - ページの複製
• renamePage - ページの移動/リネーム
• searchPages - ページの検索
• getRecentPages - 最近更新されたページの取得
• getPageListingRoot - ルートページ一覧の取得
• getPageListingChildren - 子ページ一覧の取得
• publishPage / unpublishPage - ページの公開/非公開

タグ操作

• getTagList - タグ一覧の取得
• searchTags - タグの検索
• updateTag - タグの更新
• getPageTag - ページのタグ取得

リビジョン操作

• listRevisions - リビジョン一覧の取得
• getRevision - リビジョンの取得

共有リンク操作

• getShareLinks - 共有リンク一覧の取得
• createShareLink - 共有リンクの作成
• deleteShareLink - 共有リンクの削除

コメント操作

• getComments - コメントの取得

ユーザー操作

• getUserRecentPages - ユーザーの最近のページ取得

セットアップ

環境変数

.env.exampleをコピーして.envを作成：

cp .env.example .env

変数名	説明	例
MCP_HTTP_PORT	サーバーポート	3001
MCP_HTTP_HOST	リッスンホスト	0.0.0.0
MCP_AUTH_TOKENS	Bearer認証トークン (32文字以上、カンマ区切りで複数可)	your-secure-token...
GROWI_DEFAULT_APP_NAME	デフォルトのGROWIアプリ名	app-1
GROWI_APP_NAME_N	GROWIアプリ名 (N=1,2,3...)	app-1
GROWI_API_TOKEN_N	GROWI APIトークン	8991502f6dfec...
GROWI_BASE_URL_N	GROWI URL	http://localhost:3000

起動方法

Docker Compose (Cloudflare Tunnel)

Cloudflare Tunnelを使用して、自己署名証明書なしでHTTPSアクセスを実現します。

1. Cloudflare Tunnelを作成：

   • Cloudflare Zero Trust にアクセス
   • Networks > Tunnels > Create a tunnel
   • トンネル名を入力して作成
   • トークンをコピー

2. トンネルの Public Hostname を設定：

   • Subdomain: 任意（例: growi-mcp）
   • Domain: Cloudflareに登録済みのドメイン
   • Service Type: HTTP
   • URL: growi-mcp:3001

3. .envを設定：

   cp .env.example .env
   # CLOUDFLARE_TUNNEL_TOKEN にトークンを設定
   

4. 起動：

   docker compose up -d
   

5. アクセス：

   • https://growi-mcp.your-domain.com/mcp

ローカル開発

# 依存関係のインストール
pnpm install

# 開発サーバー起動
pnpm dev

# ビルド
pnpm build

# 本番起動
pnpm start

API

エンドポイント

• GET /health - ヘルスチェック
• POST /mcp - MCPリクエスト

認証

リクエストヘッダーにBearerトークンを含める：

Authorization: Bearer your-secure-token-at-least-32-characters-long

ライセンス

MIT