AWS CodePipeline MCP 服务器

这是一个与 AWS CodePipeline 集成的模型上下文协议 (MCP) 服务器，允许您通过 Windsurf 和 Cascade 管理管道。该服务器提供了与 AWS CodePipeline 服务交互的标准化接口。

作者： Cuong T Nguyen

特征

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

Related MCP server: Code Merge MCP

先决条件

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

安装

克隆此存储库：

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

安装依赖项：

npm install

根据.env.example模板创建.env文件：

cp .env.example .env

使用您的 AWS 凭证和配置更新.env文件：

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

注意：为了安全起见，切勿将您的.env文件提交到版本控制。

用法

构建项目

npm run build

启动服务器

npm start

对于自动重启的开发：

npm run dev

与 Windsurf 集成

该 MCP 服务器旨在与 Windsurf 配合使用，允许 Cascade 通过自然语言请求与 AWS CodePipeline 进行交互。

设置步骤

确保服务器正在运行：

npm start

将服务器配置添加到 Windsurf MCP 配置文件~/.codeium/windsurf/mcp_config.json中：

{ "mcpServers": { "codepipeline": { "command": "npx", "args": [ "-y", "path/to/mcp-codepipeline-server/dist/index.js" ], "env": { "AWS_REGION": "us-east-1", "AWS_ACCESS_KEY_ID": "your_access_key_id", "AWS_SECRET_ACCESS_KEY": "your_secret_access_key" } } } }

mkdir -p ~/.codeium/windsurf touch ~/.codeium/windsurf/mcp_config.json

重新启动 Windsurf 以加载新的 MCP 服务器配置

与 Cascade 一起使用

配置完成后，您可以在 Windsurf 中使用自然语言与 AWS CodePipeline 进行交互。例如：

“列出我的所有 CodePipeline 管道”
“显示我的‘生产部署’管道的当前状态”
“触发‘测试构建’管道”
“获取我的‘数据处理’管道的指标”
“为我的‘前端部署’管道创建一个 webhook”

Cascade 会将这些请求转换为适当的 MCP 工具调用。

MCP 工具

核心管道管理

工具名称	描述	参数
`list_pipelines`	列出所有 CodePipeline 管道	没有任何
`get_pipeline_state`	获取特定管道的状态	`pipelineName` ：管道的名称
`list_pipeline_executions`	列出特定管道的执行	`pipelineName` ：管道的名称
`trigger_pipeline`	触发管道执行	`pipelineName` ：管道的名称
`stop_pipeline_execution`	停止管道执行	`pipelineName` ：管道的名称 `executionId` ：执行 ID `reason` ：可选的停止原因

管道详细信息和指标

工具名称	描述	参数
`get_pipeline_details`	获取管道的完整定义	`pipelineName` ：管道的名称
`get_pipeline_execution_logs`	获取管道执行的日志	`pipelineName` ：管道的名称 `executionId` ：执行 ID
`get_pipeline_metrics`	获取管道的性能指标	`pipelineName` ：管道名称 `period` ：可选指标周期（以秒为单位） `startTime` ：可选指标开始时间 `endTime` ：可选指标结束时间

管道操作和集成

工具名称	描述	参数
`approve_action`	批准或拒绝手动批准操作	`pipelineName` ：管道的名称 `stageName` ：阶段的名称 `actionName` ：操作的名称 `token` ：批准令牌 `approved` ：表示批准或拒绝的布尔值 `comments` ：可选注释
`retry_stage`	重试失败的阶段	`pipelineName` ：管道的名称 `stageName` ：阶段的名称 `pipelineExecutionId` ：执行 ID
`tag_pipeline_resource`	添加或更新管道资源的标签	`pipelineName` ：管道的名称 `tags` ：用于标记的键值对数组
`create_pipeline_webhook`	为管道创建 webhook	`pipelineName` ：管道的名称 `webhookName` ：webhook 的名称 `targetAction` ：webhook 的目标操作 `authentication` ：身份验证类型 `authenticationConfiguration` ：可选的身份验证配置 `filters` ：可选的事件过滤器

故障排除

常见问题

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

日志

服务器将信息记录到控制台。检查以下日志以进行故障排除：

# Run with more verbose logging DEBUG=* npm start

示例

为 GitHub 集成创建 Webhook

{ "pipelineName": "my-pipeline", "webhookName": "github-webhook", "targetAction": "Source", "authentication": "GITHUB_HMAC", "authenticationConfiguration": { "SecretToken": "my-secret-token" }, "filters": [ { "jsonPath": "$.ref", "matchEquals": "refs/heads/main" } ] }