AWS CodePipeline MCP Server

Features

• List all pipelines

• Get pipeline state and detailed pipeline definitions

• List pipeline executions

• Approve or reject manual approval actions

• Retry failed stages

• Trigger pipeline executions

• View pipeline execution logs

• Stop pipeline executions

• Tag pipeline resources

• Create webhooks for automatic pipeline triggering

• Get pipeline performance metrics

Prerequisites

• Node.js (v14 or later)

• AWS account with CodePipeline access

• AWS credentials with permissions for CodePipeline, CloudWatch, and IAM (for tagging)

• Windsurf IDE with Cascade AI assistant

Installation

1. Clone this repository:

1. Install dependencies:

1. Create a `.env` file based on the `.env.example` template:

1. Update the `.env` file with your AWS credentials and configuration:

**Note**: For security, never commit your `.env` file to version control.

Usage

Build the project

Start the server

Integration with Windsurf

Setup Steps

1. Make sure the server is running:

1. Add the server configuration to your Windsurf MCP config file at `~/.codeium/windsurf/mcp_config.json`:

1. Create the directory if it doesn't exist:

1. Restart Windsurf to load the new MCP server configuration

Using with Cascade

• "List all my CodePipeline pipelines"

• "Show me the current state of my 'production-deploy' pipeline"

• "Trigger the 'test-build' pipeline"

• "Get metrics for my 'data-processing' pipeline"

• "Create a webhook for my 'frontend-deploy' pipeline"

MCP Tools

Core Pipeline Management

Pipeline Details and Metrics

Pipeline Actions and Integrations

Troubleshooting

Common Issues

1. **Connection refused error**: - Ensure the server is running on the specified port - Check if the port is blocked by a firewall

2. **AWS credential errors**: - Verify your AWS credentials in the `.env` file - Ensure your IAM user has the necessary permissions

3. **Windsurf not detecting the MCP server**: - Check the `mcp_config.json` file format - Ensure the server URL is correct - Restart Windsurf after making changes

Logs

Examples

Creating a Webhook for GitHub Integration

Getting Pipeline Metrics

License