docmost-mcp

自己ホスト型の Docmost ウィキに、通常の REST API 経由で AI エージェントに読み書きアクセスを提供する MCP サーバー。

存在理由

Docmost には独自の MCP エンドポイントが同梱されていますが、有料ライセンスの後ろにゲートされています。設定 UI では API 管理について "Available with a paid license" と表示され、Community Edition では /api/mcp は 404 を返します。API キーの発行も同様にゲートされています。

ただし、通常の REST API は Community Edition で完全に利用可能です。このサーバーはその REST API の薄いラッパーであり、同じ操作を API キーではなくセッション認証で実行します。

Related MCP server: MediaWiki MCP Server

要件

• Python 3.11+

• HTTP(S) 経由で到達可能な Docmost インスタンス

• エージェント専用の Docmost ユーザーアカウント

インストール

git clone https://github.com/<you>/docmost-mcp.git
cd docmost-mcp
python3 -m venv venv
./venv/bin/pip install -r requirements.txt

設定

サンプル設定をコピーして記入してください:

cp config.example.json config.json
chmod 600 config.json

{
  "url": "https://docmost.example.com",
  "api_key": "",
  "email": "agent@example.com",
  "password": "..."
}

2 つの認証モードがサポートされています:

api_key が設定されている場合はそれが優先され、それ以外の場合は資格情報が使用されます。

設定パスは DOCMOST_MCP_CONFIG 環境変数で上書きできます。

専用アカウントを作成する

ワークスペース所有者の資格情報を使用しないでください。別のユーザーを招待し (Settings → Members → Invite)、エージェントが必要とするスペースにのみアクセスを許可してください。Docmost のスペースへのアクセスは通常、デフォルトの Everyone グループから継承されるため、エージェントが制限されていると想定する前に、そのグループがアクセスできる範囲を確認してください。

2 つ目のメールボックスを作成したくない場合は、Gmail 形式のプラスアドレス (you+agent@gmail.com) を使用できます。

動作確認

selftest.py はチェーン全体 (ログイン、読み取り、書き込み、読み返し、削除) を実行します:

./venv/bin/python selftest.py

エージェントの接続

サーバーは stdio 上で MCP を通信します。

Claude Code

claude mcp add docmost -- /path/to/docmost-mcp/venv/bin/python /path/to/docmost-mcp/server.py

または手動で ~/.claude.json に追加します:

{
  "mcpServers": {
    "docmost": {
      "type": "stdio",
      "command": "/path/to/docmost-mcp/venv/bin/python",
      "args": ["/path/to/docmost-mcp/server.py"],
      "env": {}
    }
  }
}

その後 Claude Code を再起動してください。設定は起動時に読み込まれます。

Claude Desktop

同じブロックを claude_desktop_config.json に追加します:

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

• Windows: %APPDATA%\Claude\claude_desktop_config.json

Cursor

プロジェクト内の .cursor/mcp.json またはグローバルの ~/.cursor/mcp.json に、同じ mcpServers の形式で追加します。

その他の MCP クライアント

virtualenv の Python で server.py を起動し、stdin と stdout で JSON-RPC を送受信します。最小限のハンドシェイク:

{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"probe","version":"1"}}}
{"jsonrpc":"2.0","method":"notifications/initialized"}
{"jsonrpc":"2.0","id":2,"method":"tools/list"}

便利なラッパーを使うとコマンドを短くできます:

#!/bin/sh
exec /path/to/docmost-mcp/venv/bin/python /path/to/docmost-mcp/server.py "$@"

ツール

fmt は markdown (デフォルト)、html、json のいずれかです。

Docmost API の注意点

このサーバーを拡張する場合に知っておくと役立つこと:

• 読み取りを含むすべてのエンドポイントが POST です。

• /pages/create と /pages/update は format フィールド (json | markdown | html) が 必須 です。省略すると 400 が返ります。

• レスポンスはペイロードを {"data": ...} でラップします。クライアント側でそれをアンラップします。

• Community Edition では /api/api-keys は空のリストで 200 を返します。一覧表示は開放されており、キーの 作成 のみがライセンスで制限されています。

• エンドポイントのパスとペイロードの構造は、推測ではなく Docmost クライアントのソース (apps/client/src/features/*/services/*.ts) から取得したものです。

セキュリティ

• config.json には平文のパスワードが含まれます。パーミッションを 600 に保ち、バージョン管理の対象外にしてください。.gitignore に含まれています。

• エージェントアカウントには、作業に必要な最小限のスペースアクセスのみを付与してください。

• アカウントの操作は Docmost 上でそのアカウントの名前で表示されるため、ページ履歴は誰の操作か追跡可能です。

互換性

Docmost 0.95.0 と Python MCP SDK 2.0 を対象に構築されています。SDK 2.0 では FastMCP が MCPServer に名前変更され、mcp.server に移動したことに注意してください。2.0 より前のインポートパス mcp.server.fastmcp は機能しません。

ライセンス

MIT — LICENSE を参照してください。

このプロジェクトは Docmost とは提携関係にありません。