AWS CodePipeline MCP 服务器

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

作者： Cuong T Nguyen

功能

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

前提条件

• 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

2. 安装依赖项：

npm install

3. 基于 .env.example 模板创建一个 .env 文件：

cp .env.example .env

4. 使用您的 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 交互。

设置步骤

1. 确保服务器正在运行：

npm start

2. 将服务器配置添加到您的 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"
      }
    }
  }
}

3. 如果目录不存在，则创建该目录：

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

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

与 Cascade 一起使用

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

• "列出我所有的 CodePipeline 管道"
• "显示我 'production-deploy' 管道的当前状态"
• "触发 'test-build' 管道"
• "获取我的 'data-processing' 管道的指标"
• "为我的 'frontend-deploy' 管道创建一个 Webhook"

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

MCP 工具

核心管道管理

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

管道详细信息和指标

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

管道操作和集成

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

故障排除

常见问题

1. 连接被拒绝错误：

   • 确保服务器正在指定的端口上运行
   • 检查端口是否被防火墙阻止

2. AWS 凭证错误：

   • 验证 .env 文件中的 AWS 凭证
   • 确保您的 IAM 用户具有必要的权限

3. Windsurf 未检测到 MCP 服务器：

   • 检查 mcp_config.json 文件格式
   • 确保服务器 URL 正确
   • 更改后重新启动 Windsurf

日志

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

# 以更详细的日志记录运行
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"
    }
  ]
}

获取管道指标

{
  "pipelineName": "my-pipeline",
  "period": 86400,
  "startTime": "2025-03-10T00:00:00Z",
  "endTime": "2025-03-17T23:59:59Z"
}

许可证

ISC