MCP Codepipeline Server

🚀 AWS CodePipeline MCP 服務器

這是一個 Model Context Protocol (MCP) 服務器，它與 AWS CodePipeline 集成，讓您能夠通過 Windsurf 和 Cascade 管理並操作管道。該服務器功能豐富，可實現管道的創建、修改、刪除，還能對管道資源進行監控和管理。

🚀 快速開始

本服務器提供了豐富的功能，能幫助您高效管理和操作管道。在使用前，請確保滿足先決條件，並按照安裝步驟完成安裝。

✨ 主要特性

• 管道生命週期管理：支持管道的創建、啟動、停止和刪除操作。
• 資源監控與報警：即時監控管道運行狀態，提供詳細的運行日誌，並可以根據預設條件觸發報警。
• 擴展集成：支持與其他 AWS 服務（如 CloudWatch、S3 等）集成，實現自動化工作流。
• 多租戶支持：支持在不同環境中獨立管理管道資源，適合企業級用戶。

📦 安裝指南

先決條件

1. 操作系統要求：Linux 或 macOS
2. Node.js 版本：>= 14.x
3. npm 版本：>= 6.x
4. AWS 賬號及相應權限（需具備 CodePipeline 和 CloudWatch 的操作權限）
5. 熟悉管道管理的基本概念和 AWS CLI 工具的使用

安裝步驟

步驟一：克隆倉庫

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

步驟二：安裝依賴

npm install

步驟三：配置環境變量

創建並編輯 .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

步驟四：啟動服務

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 賬號具有足夠的權限以執行所需操作。
• 定期備份重要的管道配置，避免因誤操作導致數據丟失。
• 在生產環境中使用前，請進行全面的功能測試和性能調優。

文檔參考

• AWS CodePipeline 用戶指南
• CodePipeline REST API 參考文檔
• CodeBuild 用戶指南
• CodeDeploy 用戶指南

支持

如需幫助或遇到問題，請聯繫我們的支持團隊：support@your-provider.com。