MCP Server for Drupal

Drupal 用 MCP サーバー

これは、STDIO トランスポートで動作する Drupal MCP モジュール 用の、TypeScript ベースのコンパニオン Model Context Protocol（MCP） サーバーです。SSE トランスポートを使用する場合、このサーバーは必要ありません。

重要

📖 詳細なドキュメントは drupalmcp.io でご覧いただけます。

インストール

STDIO バイナリは、さまざまな環境に対応するため、複数の配布チャネルから入手できます。

• Docker コンテナ
• コンパイル済みバイナリ
• JSR パッケージ

docker を使用してサーバーを利用する簡単な例を以下に示します。

{
  "mcpServers": {
    "mcp-server-drupal": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/omedia/mcp-server-drupal",
        "--drupal-url=__DRUPAL_BASE_URL_"
      ],
      "env": {}
    }
  }
}

📖 詳細については、ドキュメントのインストールのセクションをご覧ください。

認証

サーバーは、環境変数を使った認証に対応しています。認証トークン、またはユーザー名とパスワードによる基本認証を使用できます。以下の環境変数に対応しています。

• DRUPAL_AUTH_TOKEN：認証トークンです。
• DRUPAL_AUTH_USER：認証に使用するユーザー名です。
• DRUPAL_AUTH_PASSWORD：認証に使用するパスワードです。

メモ

Drupal MCP モジュールの設定ページで認証を有効にしてください。

メモ

DRUPAL_AUTH_TOKEN と DRUPAL_AUTH_USER／DRUPAL_AUTH_PASSWORD の両方が設定されている場合、ユーザー名とパスワードよりもトークンが優先されます。

📖 詳細については、ドキュメントの認証のセクションをご覧ください。

MCP

• すべてのツールは初期化フェーズで Drupal API によって定義されます。

メモ

サーバーは現在、以下を公開しています。

• リソース（テンプレート、読み取り）
• ツール（呼び出し）

現時点では、サーバーはプロンプトを公開していません。

開発

このプロジェクトは Deno で構築されています。

メモ

deno のバージョン 2.0.0 以降を使用してください。

依存関係をインストールします。

deno install

自動再ビルドを有効にして開発する場合：

bun task dev

サーバーをビルドします。

deno task build --output build/mcp-server-drupal

ヒント

特定のプラットフォーム向けにビルドするには、--target フラグを使用し、 ドキュメントを確認してください。

デバッグ

MCP サーバーは stdio 経由で通信するため、デバッグは難しい場合があります。MCP Inspector の使用をおすすめします。deno タスクとして利用できます。

deno task inspector --drupal-url [DRUPAL_BASE_URL]

バイナリとイメージの検証

drupal_mcp_server バイナリとコンテナイメージは、アイデンティティベースの署名を使用して cosign で署名されています。

リリースページから signatures.tar.gz ファイルをダウンロードし、署名を展開して以下のコマンドを実行すると、バイナリを検証できます。

cosign verify-blob ${YOUR_BINARY_NAME} \
--bundle signatures/${YOUR_BINARY_NAME}.bundle \
--certificate-oidc-issuer https://token.actions.githubusercontent.com \
--certificate-identity-regexp https://github.com/Omedia/mcp-server-drupal/.github/workflows/release.yml@refs/tags/v \
--certificate-github-workflow-repository Omedia/mcp-server-drupal

コンテナイメージは、以下のコマンドを実行して検証できます。

cosign verify ghcr.io/omedia/mcp-server-drupal:latest \
  --certificate-oidc-issuer "https://token.actions.githubusercontent.com" \
  --certificate-identity-regexp "https://github.com/Omedia/mcp-server-drupal/.github/workflows/release.yml@refs/tags/v"