🚀 AWS CodePipeline MCP 服务器
这是一个 Model Context Protocol (MCP) 服务器，它与 AWS CodePipeline 集成，让您能够通过 Windsurf 和 Cascade 管理及操作管道。该服务器功能丰富，可实现管道的创建、修改、删除，还能对管道资源进行监控和管理。
🚀 快速开始
该服务器可助力您高效管理和操作 AWS CodePipeline 管道。若想体验其功能，可按以下步骤进行部署和使用。
✨ 主要特性
- 管道生命周期管理：支持管道的创建、启动、停止和删除操作。
- 资源监控与报警：实时监控管道运行状态，提供详细的运行日志，并可以根据预设条件触发报警。
- 扩展集成：支持与其他 AWS 服务（如 CloudWatch、S3 等）集成，实现自动化工作流。
- 多租户支持：支持在不同环境中独立管理管道资源，适合企业级用户。
📦 安装指南
先决条件
- 操作系统要求：Linux 或 macOS
- Node.js 版本：>= 14.x
- npm 版本：>= 6.x
- AWS 账号及相应权限（需具备 CodePipeline 和 CloudWatch 的操作权限）
- 熟悉管道管理的基本概念和 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"
}
}
}
管道清理策略
为了确保管道资源的整洁，建议实施以下清理策略：
- 定期检查未使用的管道：使用 AWS CLI 定期列出所有管道，并移除不再需要的管道。
- 设置默认过期时间：对于试验性质的管道，可以配置一个合理的过期时间，在超过指定时长后自动删除管道。
- 监控资源使用情况：通过 CloudWatch 监控管道运行次数和耗时，分析是否存在冗余或低效的管道。
📚 详细文档
注意事项
- 确保 AWS 账号具有足够的权限以执行所需操作。
- 定期备份重要的管道配置，避免因误操作导致数据丢失。
- 在生产环境中使用前，请进行全面的功能测试和性能调优。
文档参考
支持
如需帮助或遇到问题，请联系我们的支持团队：support@your-provider.com。