AWS CodePipeline MCP-Server

Dies ist ein Model Context Protocol (MCP)-Server, der in AWS CodePipeline integriert ist und Ihnen die Verwaltung Ihrer Pipelines über Windsurf und Cascade ermöglicht. Der Server bietet eine standardisierte Schnittstelle für die Interaktion mit AWS CodePipeline-Diensten.

Autor: Cuong T Nguyen

Merkmale

• Alle Pipelines auflisten

• Abrufen des Pipeline-Status und detaillierter Pipeline-Definitionen

• Auflisten von Pipeline-Ausführungen

• Manuelle Genehmigungsaktionen genehmigen oder ablehnen

• Wiederholen Sie fehlgeschlagene Phasen

• Auslösen von Pipeline-Ausführungen

• Anzeigen von Pipeline-Ausführungsprotokollen

• Stoppen Sie die Pipeline-Ausführungen

• Tag-Pipeline-Ressourcen

• Erstellen Sie Webhooks für die automatische Pipeline-Auslösung

• Abrufen von Pipeline-Leistungsmetriken

Related MCP server: AWS MCP Server

Voraussetzungen

• Node.js (v14 oder höher)

• AWS-Konto mit CodePipeline-Zugriff

• AWS-Anmeldeinformationen mit Berechtigungen für CodePipeline, CloudWatch und IAM (zum Taggen)

• Windsurf IDE mit Cascade AI-Assistent

Installation

1. Klonen Sie dieses Repository:

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

2. Installieren Sie Abhängigkeiten:

npm install

3. Erstellen Sie eine .env Datei basierend auf der Vorlage .env.example :

cp .env.example .env

4. Aktualisieren Sie die .env Datei mit Ihren AWS-Anmeldeinformationen und Ihrer Konfiguration:

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

Hinweis : Übergeben Sie Ihre .env Datei aus Sicherheitsgründen niemals der Versionskontrolle.

Verwendung

Erstellen des Projekts

npm run build

Starten Sie den Server

npm start

Für die Entwicklung mit automatischem Neustart:

npm run dev

Integration mit Windsurf

Dieser MCP-Server ist für die Zusammenarbeit mit Windsurf konzipiert und ermöglicht Cascade die Interaktion mit AWS CodePipeline über Anfragen in natürlicher Sprache.

Einrichtungsschritte

1. Stellen Sie sicher, dass der Server läuft:

npm start

2. Fügen Sie die Serverkonfiguration zu Ihrer Windsurf MCP-Konfigurationsdatei unter ~/.codeium/windsurf/mcp_config.json hinzu:

{
 "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. Erstellen Sie das Verzeichnis, falls es nicht existiert:

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

4. Starten Sie Windsurf neu, um die neue MCP-Serverkonfiguration zu laden

Verwendung mit Cascade

Nach der Konfiguration können Sie in Windsurf mithilfe natürlicher Sprache mit AWS CodePipeline interagieren. Beispiel:

• „Liste alle meine CodePipeline-Pipelines auf“

• „Zeigen Sie mir den aktuellen Status meiner Produktions- und Bereitstellungspipeline.“

• „Lösen Sie die Test-Build-Pipeline aus“

• „Metriken für meine ‚Datenverarbeitungs‘-Pipeline abrufen“

• „Erstellen Sie einen Webhook für meine ‚Frontend-Deploy‘-Pipeline.“

Cascade übersetzt diese Anfragen in die entsprechenden MCP-Tool-Aufrufe.

MCP-Tools

Kern-Pipeline-Management

Pipeline-Details und -Metriken

Pipeline-Aktionen und -Integrationen

Fehlerbehebung

Häufige Probleme

1. Fehler: Verbindung abgelehnt :

   • Stellen Sie sicher, dass der Server auf dem angegebenen Port läuft

   • Überprüfen Sie, ob der Port durch eine Firewall blockiert ist

2. AWS-Anmeldeinformationsfehler :

   • Überprüfen Sie Ihre AWS-Anmeldeinformationen in der .env Datei

   • Stellen Sie sicher, dass Ihr IAM-Benutzer über die erforderlichen Berechtigungen verfügt

3. Windsurf erkennt den MCP-Server nicht :

   • Überprüfen Sie das Dateiformat mcp_config.json

   • Stellen Sie sicher, dass die Server-URL korrekt ist

   • Starten Sie Windsurf neu, nachdem Sie Änderungen vorgenommen haben

Protokolle

Der Server protokolliert Informationen in der Konsole. Überprüfen Sie diese Protokolle zur Fehlerbehebung:

# Run with more verbose logging
DEBUG=* npm start

Beispiele

Erstellen eines Webhooks für die GitHub-Integration

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

Abrufen von Pipeline-Metriken

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

Lizenz

ISC

Maintenance

Resources

• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• approve_actionC
• create_pipeline_webhookC
• get_pipeline_detailsC
• get_pipeline_execution_logsC
• get_pipeline_metricsC
• get_pipeline_stateC
• list_pipeline_executionsC
• list_pipelinesB