Netlify MCP Server

🚀 Netlify CLI v19.1.5とMCPサーバーの統合ガイド

このガイドでは、Netlify CLI v19.1.5をMCPサーバーと統合する方法について説明します。Netlify CLIを使用することで、サイト管理、環境変数管理、関数ログの確認などの操作を行うことができます。

🚀 クイックスタート

Netlify CLIをMCPサーバーと統合するには、以下の手順に従ってください。

インストール

1. プロジェクトリポジトリをクローンします。

git clone https://github.com/yourusername/mcp-netlify.git
cd mcp-netlify

2. npmパッケージをインストールします。

npm install

開発サーバーの起動

npm run dev

本番バージョンのビルド

npm run build

コマンドのテスト

1. すべてのサイトをリストします。

npm run command sites:list

2. 新しいサイトを作成します。

npm run command sites:create -- --token=your PAT here

3. 指定したサイトを削除します。

npm run command sites:delete -- --site-id=your site ID here

環境変数操作の検証

1. すべての環境変数をリストします。

npm run command env:list -- --site-id=your site ID here

2. 新しい環境変数を作成します。

npm run command env:create -- --site-id=your site ID here --key=NEW_VAR --value="hello world"

3. 既存の環境変数を更新します。

npm run command env:update -- --site-id=your site ID here --key=EXISTING_VAR --value="new value"

4. 特定の環境変数を削除します。

npm run command env:delete -- --site-id=your site ID here --key=OLD_VAR

✨ 主な機能

• サイトの作成、一覧表示、削除
• 環境変数の作成、一覧表示、更新、削除
• 関数ログの確認
• リソースへのアクセスURIの提供

📦 インストール

上記の「クイックスタート」セクションに記載されている手順に従って、必要な依存関係をインストールしてください。

💻 使用例

基本的な使用法

サイト管理

サイトの作成

netlify sites:create --token=your PAT here

サイトの一覧表示

netlify sites:list

サイトの削除

netlify sites:delete --site-id=your site ID here

環境変数管理

環境変数の一覧表示

netlify env:list --site-id=your site ID here

環境変数の作成

netlify env:create --site-id=your site ID here --key=NEW_VAR --value="hello world"

環境変数の更新

netlify env:update --site-id=your site ID here --key=EXISTING_VAR --value="new value"

環境変数の削除

netlify env:delete --site-id=your site ID here --key=OLD_VAR

関数ログの確認

netlify logs:functions --site-id=your site ID here --function=my-function-name

高度な使用法

リソースアクセスURIの使用

• netlify://sites: すべてのサイトをリストします（sites:list --json のJSON出力と同等）
• netlify://sites/{siteId}/functions: 指定したサイトの関数をリストします（functions:list --json と同等で、NETLIFY_SITE_ID={siteId} 環境変数を設定する必要があります）
• netlify://sites/{siteId}/env: 指定したサイトの環境変数をリストします（env:list --json と同等で、NETLIFY_SITE_ID={siteId} 環境変数を設定する必要があります）

🔧 技術詳細

制限事項

• 対話型コマンド: ユーザー入力を必要とするコマンド（netlify login、netlify init、netlify dev など）は、このサーバーを通じて実行することはできません。個人アクセストークンを使用して認証してください。
• サイトコンテキスト: 複数のコマンド（env:*、logs:function、build、trigger-build、functions:list など）は、サイトコンテキストが必要です。このサーバーは NETLIFY_SITE_ID 環境変数を設定することで、必要な siteId を渡します。status や delete などのコマンドは、--site-id パラメータを手動で指定する必要があります。
• 機能制限: この統合では、以下の機能はサポートされていません。
  • 設定ファイルの使用
  • サイトのデプロイ
  • フックの管理
  • ドメインの管理