Servidor MCP de AWS CodePipeline

Este es un servidor de Protocolo de Contexto de Modelo (MCP) que se integra con AWS CodePipeline, lo que le permite administrar sus pipelines mediante Windsurf y Cascade. El servidor proporciona una interfaz estandarizada para interactuar con los servicios de AWS CodePipeline.

Autor: Cuong T Nguyen

Características

Listar todas las tuberías
Obtener el estado de la tubería y definiciones detalladas de la tubería
Lista de ejecuciones de pipeline
Aprobar o rechazar acciones de aprobación manual
Reintentar etapas fallidas
Ejecuciones de canalización de activación
Ver registros de ejecución de canalizaciones
Detener las ejecuciones de tuberías
Recursos de canalización de etiquetas
Crear webhooks para la activación automática de pipelines
Obtenga métricas de rendimiento del pipeline

Prerrequisitos

Node.js (v14 o posterior)
Cuenta de AWS con acceso a CodePipeline
Credenciales de AWS con permisos para CodePipeline, CloudWatch e IAM (para etiquetado)
IDE de Windsurf con asistente de IA en cascada

Instalación

Clonar este repositorio:

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

Instalar dependencias:

npm install

Cree un archivo .env basado en la plantilla .env.example :

cp .env.example .env

Actualice el archivo .env con sus credenciales y configuración de AWS:

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

Nota : por seguridad, nunca envíe su archivo .env al control de versiones.

Uso

Construir el proyecto

npm run build

Iniciar el servidor

npm start

Para desarrollo con reinicio automático:

npm run dev

Integración con Windsurf

Este servidor MCP está diseñado para funcionar con Windsurf, lo que permite que Cascade interactúe con AWS CodePipeline a través de solicitudes de lenguaje natural.

Pasos de configuración

Asegúrese de que el servidor esté ejecutándose:

npm start

Agregue la configuración del servidor a su archivo de configuración Windsurf MCP en ~/.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" } } } }

Crea el directorio si no existe:

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

Reinicie Windsurf para cargar la nueva configuración del servidor MCP

Uso con Cascade

Una vez configurado, puede interactuar con AWS CodePipeline usando lenguaje natural en Windsurf. Por ejemplo:

"Enumerar todos mis pipelines de CodePipeline"
"Muéstrame el estado actual de mi flujo de producción-implementación"
Activar el flujo de trabajo de prueba y compilación
Obtener métricas para mi flujo de trabajo de 'procesamiento de datos'
"Crear un webhook para mi pipeline 'frontend-deploy'"

Cascade traducirá estas solicitudes en las llamadas de herramientas MCP adecuadas.

Herramientas MCP

Gestión de tuberías centrales

Nombre de la herramienta	Descripción	Parámetros
`list_pipelines`	Listar todos los pipelines de CodePipeline	Ninguno
`get_pipeline_state`	Obtener el estado de una tubería específica	`pipelineName` : Nombre del pipeline
`list_pipeline_executions`	Lista de ejecuciones para una canalización específica	`pipelineName` : Nombre del pipeline
`trigger_pipeline`	Activar la ejecución de una canalización	`pipelineName` : Nombre del pipeline
`stop_pipeline_execution`	Detener la ejecución de una canalización	`pipelineName` : Nombre de la canalización `executionId` : ID de ejecución `reason` : Motivo opcional para detenerse

Detalles y métricas del pipeline

Nombre de la herramienta	Descripción	Parámetros
`get_pipeline_details`	Obtenga la definición completa de una tubería	`pipelineName` : Nombre del pipeline
`get_pipeline_execution_logs`	Obtener registros de la ejecución de una canalización	`pipelineName` : Nombre de la canalización `executionId` : ID de ejecución
`get_pipeline_metrics`	Obtener métricas de rendimiento para una canalización	`pipelineName` : Nombre del pipeline `period` : Periodo de métrica opcional en segundos `startTime` : Hora de inicio opcional para las métricas `endTime` : Hora de finalización opcional para las métricas

Acciones e integraciones de pipeline

Nombre de la herramienta	Descripción	Parámetros
`approve_action`	Aprobar o rechazar una acción de aprobación manual	`pipelineName` : Nombre del pipeline `stageName` : Nombre de la etapa `actionName` : Nombre de la acción `token` : Token de aprobación `approved` : Booleano que indica aprobación o rechazo `comments` : Comentarios opcionales
`retry_stage`	Reintentar una etapa fallida	`pipelineName` : Nombre de la canalización `stageName` : Nombre de la etapa `pipelineExecutionId` : ID de ejecución
`tag_pipeline_resource`	Agregar o actualizar etiquetas para un recurso de canalización	`pipelineName` : Nombre de la canalización `tags` : Matriz de pares clave-valor para etiquetado
`create_pipeline_webhook`	Crear un webhook para una canalización	`pipelineName` : Nombre de la canalización `webhookName` : Nombre del webhook `targetAction` : Acción de destino para el webhook `authentication` : Tipo de autenticación `authenticationConfiguration` : Configuración de autenticación opcional `filters` : Filtros de eventos opcionales

Solución de problemas

Problemas comunes

Error de conexión rechazada :
- Asegúrese de que el servidor se esté ejecutando en el puerto especificado
- Compruebe si el puerto está bloqueado por un firewall
Errores de credenciales de AWS :
- Verifique sus credenciales de AWS en el archivo .env
- Asegúrese de que su usuario de IAM tenga los permisos necesarios
Windsurf no detecta el servidor MCP :
- Verifique el formato del archivo mcp_config.json
- Asegúrese de que la URL del servidor sea correcta
- Reiniciar Windsurf después de realizar cambios

Registros

El servidor registra información en la consola. Consulte estos registros para solucionar problemas:

# Run with more verbose logging DEBUG=* npm start

Ejemplos

Creación de un webhook para la integración de GitHub

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

Obtención de métricas de pipeline

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

Licencia

ISC

Deploy Server

A

security – no known vulnerabilities

-

license - not tested

A

quality - confirmed to work

How are these scores calculated?

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Tools

View all tools

Un servidor de protocolo de contexto de modelo que se integra con AWS CodePipeline, lo que permite a los usuarios administrar canalizaciones a través de Windsurf y Cascade utilizando comandos de lenguaje natural.

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-server-code-assist
abhishekbhakat
A
security
-
license
A
quality
A Model Context Protocol server that provides tools for code modification and generation via Large Language Models, allowing users to create, modify, rewrite, and delete files using structured XML instructions.
Last updated -
12
2
MIT License
Code Merge MCP
yy1588133
A
security
-
license
A
quality
A Model Context Protocol server that helps large language models process code repositories by providing file tree generation, code merging, and code analysis capabilities.
Last updated -
3
22
MIT License
Cloud Manage MCP Server
rainhan99
A
security
-
license
A
quality
A Model Context Protocol server for managing cloud servers, particularly DigitalOcean droplets, allowing users to identify providers via IP addresses and perform operations like power management, status monitoring, and resource usage tracking.
Last updated -
30
1
Enhanced File Operations MCP Server
SkippyzNJiff
-
security
-
license
-
quality
A comprehensive Model Context Protocol server that provides over 50 file and system management tools for AI models, including navigation, file operations, search, compression, and system information capabilities.
Last updated -

View all related MCP servers

AWS CodePipeline MCP Server