uild ``` ### Start the server ```bash npm start ``` For development with auto-restart: ```bash npm run dev ``` ## Integration with Windsurf This MCP server is designed to work with Windsurf, allowing Cascade to interact with AWS CodePipeline through natural language requests. ### Setup Steps 1. Make sure the server is running: ```bash npm start ``` 2. Add the server configuration to your Windsurf MCP config file at `~/.codeium/windsurf/mcp_config.json`: ```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. Create the directory if it doesn't exist: ```bash mkdir -p ~/.codeium/windsurf touch ~/.codeium/windsurf/mcp_config.json ``` 4. Restart Windsurf to load the new MCP server configuration ### Using with Cascade Once configured, you can interact with AWS CodePipeline using natural language in Windsurf. For example: - "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" Cascade will translate these requests into the appropriate MCP tool calls. ## MCP Tools ### Core Pipeline Management | Tool Name | Description | Parameters | |-----------|-------------|------------| | `list_pipelines` | List all CodePipeline pipelines | None | | `get_pipeline_state` | Get the state of a specific pipeline | `pipelineName`: Name of the pipeline | | `list_pipeline_executions` | List executions for a specific pipeline | `pipelineName`: Name of the pipeline | | `trigger_pipeline` | Trigger a pipeline execution | `pipelineName`: Name of the pipeline | | `stop_pipeline_execution` | Stop a pipeline execution | `pipelineName`: Name of the pipeline
`executionId`: Execution ID
`reason`: Optional reason for stopping | ### Pipeline Details and Metrics | Tool Name | Description | Parameters | |-----------|-------------|------------| | `get_pipeline_details` | Get the full definition of a pipeline | `pipelineName`: Name of the pipeline | | `get_pipeline_execution_logs` | Get logs for a pipeline execution | `pipelineName`: Name of the pipeline
`executionId`: Execution ID | | `get_pipeline_metrics` | Get performance metrics for a pipeline | `pipelineName`: Name of the pipeline
`period`: Optional metric period in seconds
`startTime`: Optional start time for metrics
`endTime`: Optional end time for metrics | ### Pipeline Actions and Integrations | Tool Name | Description | Parameters | |-----------|-------------|------------| | `approve_action` | Approve or reject a manual approval action | `pipelineName`: Name of the pipeline
`stageName`: Name of the stage
`actionName`: Name of the action
`token`: Approval token
`approved`: Boolean indicating approval or rejection
`comments`: Optional comments | | `retry_stage` | Retry a failed stage | `pipelineName`: Name of the pipeline
`stageName`: Name of the stage
`pipelineExecutionId`: Execution ID | | `tag_pipeline_resource` | Add or update tags for a pipeline resource | `pipelineName`: Name of the pipeline
`tags`: Array of key-value pairs for tagging | | `create_pipeline_webhook` | Create a webhook for a pipeline | `pipelineName`: Name of the pipeline
`webhookName`: Name for the webhook
`targetAction`: Target action for the webhook
`authentication`: Authentication type
`authenticationConfiguration`: Optional auth config
`filters`: Optional event filters | ## 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 necessar

AWS CodePipeline MCP Server

Tools