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。