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

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

Klonen Sie dieses Repository:

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

Installieren Sie Abhängigkeiten:

npm install

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

cp .env.example .env

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

Stellen Sie sicher, dass der Server läuft:

npm start

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" } } } }

Erstellen Sie das Verzeichnis, falls es nicht existiert:

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

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

Werkzeugname	Beschreibung	Parameter
`list_pipelines`	Alle CodePipeline-Pipelines auflisten	Keiner
`get_pipeline_state`	Abrufen des Status einer bestimmten Pipeline	`pipelineName` : Name der Pipeline
`list_pipeline_executions`	Ausführungen für eine bestimmte Pipeline auflisten	`pipelineName` : Name der Pipeline
`trigger_pipeline`	Auslösen einer Pipeline-Ausführung	`pipelineName` : Name der Pipeline
`stop_pipeline_execution`	Stoppen einer Pipeline-Ausführung	`pipelineName` : Name der Pipeline `executionId` : Ausführungs-ID `reason` : Optionaler Grund für das Anhalten

Pipeline-Details und -Metriken

Werkzeugname	Beschreibung	Parameter
`get_pipeline_details`	Holen Sie sich die vollständige Definition einer Pipeline	`pipelineName` : Name der Pipeline
`get_pipeline_execution_logs`	Abrufen von Protokollen für eine Pipeline-Ausführung	`pipelineName` : Name der Pipeline `executionId` : Ausführungs-ID
`get_pipeline_metrics`	Abrufen von Leistungsmetriken für eine Pipeline	`pipelineName` : Name der Pipeline `period` : Optionaler Metrikzeitraum in Sekunden `startTime` : Optionale Startzeit für Metriken `endTime` : Optionale Endzeit für Metriken

Pipeline-Aktionen und -Integrationen

Werkzeugname	Beschreibung	Parameter
`approve_action`	Genehmigen oder Ablehnen einer manuellen Genehmigungsaktion	`pipelineName` : Name der Pipeline `stageName` : Name der Phase `actionName` : Name der Aktion `token` : Genehmigungstoken `approved` : Boolescher Wert, der Genehmigung oder Ablehnung anzeigt `comments` : Optionale Kommentare
`retry_stage`	Wiederholen Sie eine fehlgeschlagene Phase	`pipelineName` : Name der Pipeline `stageName` : Name der Stufe `pipelineExecutionId` : Ausführungs-ID
`tag_pipeline_resource`	Hinzufügen oder Aktualisieren von Tags für eine Pipeline-Ressource	`pipelineName` : Name der Pipeline. `tags` : Array von Schlüssel-Wert-Paaren zum Taggen
`create_pipeline_webhook`	Erstellen eines Webhooks für eine Pipeline	`pipelineName` : Name der Pipeline `webhookName` : Name für den Webhook `targetAction` : Zielaktion für den Webhook `authentication` : Authentifizierungstyp `authenticationConfiguration` : Optionale Authentifizierungskonfiguration `filters` : Optionale Ereignisfilter

Fehlerbehebung

Häufige Probleme

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
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
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

Deploy Server

HTTP connection URL

A

security – no known vulnerabilities

F

license - not found

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

Ein Model Context Protocol-Server, der in AWS CodePipeline integriert ist und es Benutzern ermöglicht, Pipelines über Windsurf und Cascade mithilfe von Befehlen in natürlicher Sprache zu verwalten.

Related Resources

Reddit Discussion about this server

Related MCP Servers

mcp-server-code-assist
abhishekbhakat
A
security
A
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
A
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
F
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
F
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