AWS CodePipeline MCP Server

基本能力

产品定位

AWS CodePipeline MCP Server 是一个用于管理 AWS CodePipeline 的中间件服务，通过标准化的 MCP 协议与 Windsurf 和 Cascade 集成，提供自然语言交互能力。

核心功能

• 列出所有管道
• 获取管道状态和详细定义
• 列出管道执行记录
• 批准或拒绝手动批准操作
• 重试失败的阶段
• 触发管道执行
• 查看管道执行日志
• 停止管道执行
• 标记管道资源
• 创建自动触发管道的 Webhook
• 获取管道性能指标

适用场景

• 开发团队需要自动化管理 AWS CodePipeline
• 通过自然语言交互简化管道操作
• 需要集中管理和监控多个管道
• 实现 CI/CD 管道的自动化触发和审批

MCP 工具列表

核心管道管理

• list_pipelines: 列出所有 CodePipeline 管道
• get_pipeline_state: 获取特定管道的状态
• list_pipeline_executions: 列出特定管道的执行记录
• trigger_pipeline: 触发管道执行
• stop_pipeline_execution: 停止管道执行

管道详情和指标

• get_pipeline_details: 获取管道的完整定义
• get_pipeline_execution_logs: 获取管道执行的日志
• get_pipeline_metrics: 获取管道的性能指标

管道操作和集成

• approve_action: 批准或拒绝手动批准操作
• retry_stage: 重试失败的阶段
• tag_pipeline_resource: 为管道资源添加或更新标签
• create_pipeline_webhook: 为管道创建 Webhook

常见问题解答

1. 连接被拒绝错误: 确保服务器在指定端口运行，检查防火墙是否阻止端口
2. AWS 凭证错误: 验证 .env 文件中的 AWS 凭证，确保 IAM 用户有必要的权限
3. Windsurf 未检测到 MCP 服务器: 检查 mcp_config.json 文件格式，确保服务器 URL 正确，更改后重启 Windsurf

使用教程

使用依赖

• Node.js (v14 或更高版本)
• 具有 CodePipeline 访问权限的 AWS 账户
• 具有 CodePipeline、CloudWatch 和 IAM (用于标记) 权限的 AWS 凭证
• 带有 Cascade AI 助手的 Windsurf IDE

安装教程

1. 克隆仓库:

git clone https://github.com/cuongdev/mcp-codepipeline-server.git
cd mcp-codepipeline-server

1. 安装依赖:

npm install

1. 创建 .env 文件:

cp .env.example .env

1. 更新 .env 文件:

AWS_REGION=us-east-1
AWS_ACCESS_KEY_ID=your_access_key_id
AWS_SECRET_ACCESS_KEY=your_secret_access_key
PORT=3000

调试方式

1. 构建项目:

npm run build

1. 启动服务器:

npm start

1. 开发模式(自动重启):

npm run dev

1. 更详细的日志:

DEBUG=* npm start

许可证

该项目遵循 ISC 开源许可条款。