Netlify MCP Server

Netlify MCP サーバー

Netlify サイトを管理するための Model Context Protocol（MCP）サーバーです。このサーバーを使うと、MCP 経由で Netlify の API とシームレスに連携でき、MCP 対応環境から直接サイトの作成、管理、デプロイができます。

機能

• 🚀 GitHub リポジトリから新しいサイトを作成
• 📋 ページネーションを使って既存の Netlify サイトを一覧表示
• 🔍 サイトの詳細情報を取得
• 🗑️ サイトを削除
• 🔐 Netlify API との安全な認証
• ⚡ 型安全性を備えた TypeScript で構築
• 🐳 簡単にデプロイできる Docker サポート

要件

• Node.js 18 以降
• API にアクセスできる Netlify アカウント
• サイトをデプロイするための GitHub リポジトリ

インストール

ソースから

1. このリポジトリをクローンします：

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

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

npm install

3. プロジェクトをビルドします：

npm run build

Docker を使用する場合

docker build -t netlify-mcp .
docker run -e NETLIFY_ACCESS_TOKEN=your_token_here netlify-mcp

設定

Netlify アクセストークンの取得

1. https://app.netlify.com/signup で Netlify アカウントを作成します
2. User Settings > Applications > Personal access tokens に移動します
3. 「New access token」をクリックします
4. 名前を付けます（例：「MCP Integration」）
5. 生成されたトークンをコピーします

MCP の設定

1. プロジェクトのルートに .env ファイルを作成します：

NETLIFY_ACCESS_TOKEN=your_token_here

2. MCP 設定にサーバーを追加します：

{
  "mcpServers": {
    "netlify": {
      "command": "node",
      "args": ["path/to/netlify-mcp/build/index.js"],
      "env": {
        "NETLIFY_ACCESS_TOKEN": "your_token_here"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

利用可能なツール

createSiteFromGitHub

GitHub リポジトリから新しい Netlify サイトを作成します。

interface CreateSiteFromGitHubArgs {
  name: string;          // Name for the new site (subdomain)
  repo: string;          // GitHub repository (format: owner/repo)
  branch?: string;       // Branch to deploy from (default: main)
  buildCommand: string;  // Build command to run
  publishDir: string;    // Directory containing the built files
  envVars?: Record<string, string>; // Environment variables
}

listSites

アクセス権のあるすべての Netlify サイトを一覧表示します。

interface ListSitesArgs {
  filter?: 'all' | 'owner' | 'guest';  // Filter for sites
  page?: number;         // Page number for pagination
  perPage?: number;      // Items per page (max 100)
}

getSite

特定のサイトの詳細情報を取得します。

interface GetSiteArgs {
  siteId: string;  // ID or name of the site
}

deleteSite

Netlify サイトを削除します。

interface DeleteSiteArgs {
  siteId: string;  // ID or name of the site
}

ドキュメント

詳しい情報については、以下を参照してください：

• セットアップガイド
• API ドキュメント
• 使用例

開発

# Run in development mode with auto-rebuild
npm run dev

# Clean build artifacts
npm run clean

# Build the project
npm run build

トラブルシューティング

よくある問題

1. 「NETLIFY_ACCESS_TOKEN environment variable is required」

   • トークンが環境変数または .env ファイルに設定されていることを確認してください

2. 「Failed to create site: 401 Unauthorized」

   • アクセストークンが無効または期限切れの可能性があります
   • Netlify の設定から新しいトークンを生成してください

3. 「Invalid repo format」

   • リポジトリが owner/repo の形式であることを確認してください
   • 例：https://github.com/facebook/react ではなく facebook/react

貢献

貢献を歓迎します！お気軽にプルリクエストを送信してください。

1. リポジトリをフォークします
2. 機能ブランチを作成します（git checkout -b feature/amazing-feature）
3. 変更をコミットします（git commit -m 'Add some amazing feature'）
4. ブランチにプッシュします（git push origin feature/amazing-feature）
5. プルリクエストを作成します

ライセンス

このプロジェクトは MIT ライセンスの下で公開されています。詳細は LICENSE ファイルを参照してください。

謝辞

• MCP フレームワークを提供する Model Context Protocol
• 優れたデプロイプラットフォームを提供する Netlify