Netlify MCP サーバー

Netlify CLI を介して操作するためのツールとリソースを提供する Model Context Protocol (MCP) サーバー。このサーバーは、Netlify CLI v19.1.5 と互換性があり、サイトのデプロイ、環境変数の管理、ビルドなどを可能にします。

最近の変更点（2025年4月8日）

• 互換性アップデート: Netlify CLI v19.1.5 とのツール互換性が検証されました。

• **サポートされていないツール/リソースの削除：**使用できないCLIコマンドグループ（ dns 、 forms 、 plugins 、 hooks 、 deploys ）に関連する機能が削除されました。また、 functions:delete 、 functions:invoke 、 sites:getなどの特定のコマンドも、MCPサーバー経由の非対話型使用では使用できないか、互換性がないため削除されました。

• **サイト コンテキストの回避策:**この CLI バージョンではこれらのコマンドに対して--siteフラグがサポートされていないため、サイト コンテキスト ( env:* 、 logs:function 、 build 、 trigger-build ) を必要とするツールを更新し、 NETLIFY_SITE_ID環境変数を介してsiteIdを渡すようにしました。

機能（Netlify CLI v19.1.5と互換性あり）

• サイトのデプロイと管理 ( deploy-site 、 build-site 、 trigger-build 、 link-site 、 unlink-site 、 get-status 、 create-site 、 delete-site )

• 環境変数を管理する ( set-env-vars 、 get-env-var 、 unset-env-var 、 import-env 、 clone-env-vars )

• 関数のログを取得する ( get-logs )

• リソース経由でサイトデータにアクセスする ( list-sites 、 list-functions 、 list-env-vars )

• 包括的なエラー処理

• Zodを使用した型安全なパラメータ検証

インストール

Smithery経由でインストール

Smithery経由で Claude Desktop 用の Netlify MCP Server を自動的にインストールするには:

手動インストール

1. リポジトリのクローンを作成します (まだ作成していない場合)。

2. 依存関係をインストールします:

   npm install

3. サーバーを構築します。

   npm run build

4. Netlify CLI がインストールされていることを確認します (v19.1.5 または互換バージョン)。

   # Example global install: npm install -g netlify-cli@19.1.5

認証

このMCPサーバーはNetlify CLIと連携するため、Netlifyアカウントによる認証が必要です。サーバーは非対話型で実行されるため、パーソナルアクセストークン（PAT）を使用する必要があります。

1. PAT を生成します:

   • Netlify ユーザー設定 > アプリケーション > 個人アクセス トークン (直接リンク) に移動します。

   • 新しいアクセス トークンを選択します。

   • 説明を入力します (例:「MCP サーバー トークン」)。

   • 有効期限を設定します。

   • トークンの生成を選択します。

   • トークンをすぐにコピーして安全に保管してください。

2. **トークンの設定：**このトークンをMCPサーバーでNETLIFY_AUTH_TOKEN環境変数として利用できるようにする必要があります。MCP設定ファイル内のサーバー構成のenvセクションに追加してください（下記参照）。

注意:。

構成

次の構成を MCP 設定ファイル (プラットフォームによって場所が異なります) に追加し、 "YOUR_NETLIFY_PAT_HERE"実際の個人アクセス トークンに置き換えます。

/path/to/Netlify-MCP-Server

設定ファイルの場所:

• Claude デスクトップ (macOS): ~/Library/Application Support/Claude/claude_desktop_config.json

• Cline Dev Extension (VS Code): /home/user/.codeoss-cloudworkstations/data/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json (または OS/セットアップに基づいて類似のもの)

• その他の可能性のある場所については、特定の MCP クライアントのドキュメントを参照してください。

利用可能なツール（Netlify CLI v19.1.5 互換）

(パラメータは

サイトと展開の管理

デプロイサイト

サイトディレクトリを Netlify にデプロイします。

例：

リストサイト

アカウントにリンクされているすべての Netlify サイトを一覧表示します。

例：

トリガービルド

サイトの新規ビルド/デプロイをトリガーします。サイトのコンテキストはNETLIFY_SITE_ID環境変数を介して渡されます。

例：

建設現場

Netlifyビルドをローカルで実行します（Netlifyビルド環境を模倣します）。siteIdが指定されている場合、サイトコンテキストはNETLIFY_SITE_ID siteId変数を介して渡されます。

例：

リンクサイト

現在のプロジェクト ディレクトリを Netlify サイトにリンクします (非対話型で使用する場合はサイト ID が必要です)。

例：

リンク解除サイト

現在のプロジェクト ディレクトリと関連付けられている Netlify サイトのリンクを解除します。

例：

ステータス取得

リンクされたサイト/ディレクトリの Netlify ステータスを表示します。(サーバー ディレクトリ自体がリンクされていない限り、MCP サーバー経由で実行すると失敗する可能性があります)。

例：

サイト作成

Netlify で新しいサイトを作成します (非対話型)。

例：

サイトの削除

Netlify からサイトを削除します。

例：

環境変数管理

環境変数の設定

サイトに1つ以上の環境変数を設定します。サイトのコンテキストは、 NETLIFY_SITE_ID環境変数を介して渡されます。

例：

環境変数を取得する

特定の環境変数の値を取得します。siteIdが指定siteIdれている場合、サイトコンテキストはNETLIFY_SITE_ID環境変数を介して渡されます。

例：

環境変数の設定解除

環境変数を設定解除（削除）します。siteId が指定されている場合、サイトコンテキストはNETLIFY_SITE_ID siteId変数を介して渡されます。

例：

インポート環境

.envファイルから環境変数をインポートします。サイトコンテキストはNETLIFY_SITE_ID環境変数を介して渡されます。

例：

クローン環境変数

あるサイトから別のサイトに環境変数を複製します。複製元サイトはNETLIFY_SITE_IDでリンクまたは指定する必要があります。

例：

サーバーレス関数

ログを取得する

関数のログを表示します。サイトコンテキストはNETLIFY_SITE_ID環境変数を介して渡されます。

例：

利用可能なリソース（Netlify CLI v19.1.5 互換）

次のリソース URI を使用して Netlify データに直接アクセスします。

• netlify://sites : すべてのサイトを一覧表示します ( sites:list --jsonの JSON 出力)

• netlify://sites/{siteId}/functions : サイトの関数を一覧表示します ( functions:list --jsonの JSON 出力、 NETLIFY_SITE_ID={siteId}環境変数が必要です)

• netlify://sites/{siteId}/env : サイトの環境変数を一覧表示します ( env:list --jsonの JSON 出力、 NETLIFY_SITE_ID={siteId}環境変数が必要です)

制限事項 (Netlify CLI v19.1.5)

• **対話型コマンド：**対話型プロンプトを必要とするコマンド（ netlify login 、 netlify init 、 netlify devなど）は、このサーバーではサポートされていません。認証には個人アクセストークンを使用してください。

• **サイトコンテキスト:**多くのコマンド ( env:*``status``logs:function 、 build 、 trigger-build 、 functions:list ) はサイトコンテキストを必要とします。このサーバーは、これらのコマンドを実行する際に、必要なsiteId``NETLIFY_SITE_ID環境変数を介して渡します。status やunlinkなどのコマンドは、サーバーの現在の作業ディレクトリに対して実行されます。このディレクトリは通常リンクされていないため、MCPサーバー経由で呼び出された場合、期待どおりに動作しない可能性があります。

• サポートされていないコマンド: DNS、フォーム、プラグイン、フック、およびデプロイに関連する機能 (特定のデプロイの一覧表示、デプロイ ステータスの取得) は、CLI v19.1.5 との非互換性のため削除されました。

発達

サーバーを変更するには:

1. src/index.tsのソースコードを更新します。

2. npm run buildでビルドします。

3. 変更をロードするには、クライアント アプリケーションで MCP サーバーを再起動します。

4. 変更をテストします。

リソース

• Netlify CLI ドキュメント

• MCP SDK ドキュメント

• Zodドキュメント