MCP Codepipeline Server

🚀 AWS CodePipeline MCP サーバー

このサーバーは Model Context Protocol (MCP) サーバーで、AWS CodePipeline と統合されており、Windsurf と Cascade を通じてパイプラインの管理と操作を可能にします。このサーバーは、パイプラインの作成、変更、削除、およびパイプラインリソースの監視と管理など、豊富な機能を提供します。

✨ 主な機能

• パイプラインのライフサイクル管理：パイプラインの作成、起動、停止、削除操作をサポートします。
• リソースの監視とアラート：パイプラインの実行状態をリアルタイムで監視し、詳細な実行ログを提供し、事前に設定した条件に基づいてアラートをトリガーできます。
• 拡張統合：CloudWatch、S3 などの他の AWS サービスとの統合をサポートし、自動化ワークフローを実現します。
• マルチテナントサポート：異なる環境でパイプラインリソースを独立して管理でき、企業向けユーザーに適しています。

📦 インストール

前提条件

1. オペレーティングシステム：Linux または macOS
2. Node.js バージョン：>= 14.x
3. npm バージョン：>= 6.x
4. AWS アカウントと適切な権限（CodePipeline と CloudWatch の操作権限が必要）
5. パイプライン管理の基本概念と AWS CLI ツールの使用に精通していること

インストール手順

手順 1：リポジトリをクローンする

git clone https://github.com/your-organization/aws-codepipeline-mcp.git
cd aws-codepipeline-mcp

手順 2：依存関係をインストールする

npm install

手順 3：環境変数を設定する

.env ファイルを作成して編集し、以下の内容を追加します。

# AWS 設定
AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=YOUR_ACCESS_KEY
AWS_SECRET_ACCESS_KEY=YOUR_SECRET_KEY

# MCP サービス設定
MCP_PORT=3000

手順 4：サービスを起動する

npm start

💻 使用例

基本的な使用法

パイプラインを作成する

AWS CLI を使用して新しい CodePipeline パイプラインを作成します。

aws codepipeline create-pipeline \
--name MyFirstPipeline \
--pipeline {
  "Stages": [
    {
      "Name": "Source",
      "Actions": [
        {
          "Name": "GetSource",
          "ActionTypeId": {
            "Category": "Source",
            "Owner": "ThirdParty",
            "Provider": "GitHub",
            "Version": "1"
          },
          "Configuration": {
            "Owner": "your-org",
            "Repo": "my-repo",
            "Branch": "main"
          }
        }
      ]
    },
    {
      "Name": "Build",
      "Actions": [
        {
          "Name": "BuildAction",
          "ActionTypeId": {
            "Category": "Build",
            "Owner": "AWS",
            "Provider": "CodeBuild",
            "Version": "1"
          },
          "Configuration": {
            "ProjectName": "my-build-project"
          }
        }
      ]
    }
  ],
  "Artifacts": {
    "Location": {
      "S3Location": "my-bucket/pipeline-artifacts"
    }
  }
}

パイプラインの状態を照会する

AWS CLI を使用してパイプラインの実行状態を照会します。

aws codepipeline list-pipelines --region us-east-1
aws codepipeline get-pipeline-state --name MyFirstPipeline --region us-east-1

高度な使用法

条件判断を含むパイプラインを作成する

以下は、条件判断を含む複雑なパイプライン構成の例です。

{
  "Stages": [
    {
      "Name": "Source",
      "Actions": [
        {
          "Name": "CheckoutCode",
          "ActionTypeId": {
            "Category": "Source",
            "Owner": "ThirdParty",
            "Provider": "GitHub",
            "Version": "1"
          },
          "Configuration": {
            "Repo": "my-repo",
            "Branch": "main"
          }
        }
      ]
    },
    {
      "Name": "Validation",
      "Actions": [
        {
          "Name": "ValidateCode",
          "ActionTypeId": {
            "Category": "Build",
            "Owner": "Custom",
            "Provider": "MyValidator",
            "Version": "1"
          }
        }
      ]
    },
    {
      "Name": "Build",
      "Actions": [
        {
          "Name": "BuildCode",
          "ActionTypeId": {
            "Category": "Build",
            "Owner": "AWS",
            "Provider": "CodeBuild",
            "Version": "1"
          }
        }
      ]
    },
    {
      "Name": "Deploy",
      "Conditions": [
        {
          "Type": "StringEquals",
          "Key": "ValidationResult",
          "Value": "Success"
        }
      ],
      "Actions": [
        {
          "Name": "DeployToStage",
          "ActionTypeId": {
            "Category": "Deploy",
            "Owner": "AWS",
            "Provider": "CodeDeploy",
            "Version": "1"
          },
          "Configuration": {
            "DeploymentGroupName": "my-stage-deployment-group"
          }
        }
      ]
    }
  ],
  "Artifacts": {
    "Location": {
      "S3Location": "my-bucket/pipeline-artifacts"
    }
  }
}

パイプラインのクリーンアップ戦略

パイプラインリソースの整理を確保するために、以下のクリーンアップ戦略を実施することをお勧めします。

1. 未使用のパイプラインを定期的にチェックする：AWS CLI を使用して定期的にすべてのパイプラインをリストし、不要なパイプラインを削除します。
2. デフォルトの有効期限を設定する：試験的なパイプラインには、適切な有効期限を設定し、指定された期間を超えると自動的にパイプラインを削除します。
3. リソースの使用状況を監視する：CloudWatch を使用してパイプラインの実行回数と時間を監視し、冗長または非効率的なパイプラインが存在するかどうかを分析します。

📚 ドキュメント

• AWS CodePipeline ユーザーガイド
• CodePipeline REST API リファレンスドキュメント
• CodeBuild ユーザーガイド
• CodeDeploy ユーザーガイド

📄 注意事項

⚠️ 重要提示

• AWS アカウントが必要な操作を実行するのに十分な権限を持っていることを確認してください。
• 重要なパイプライン構成を定期的にバックアップし、誤操作によるデータ損失を防いでください。
• 本番環境で使用する前に、包括的な機能テストとパフォーマンスチューニングを行ってください。

📄 サポート

ヘルプが必要な場合や問題が発生した場合は、サポートチームにお問い合わせください：support@your-provider.com。