AWS CodePipeline MCP Server

Instructions

Implementation Reference

• src/tools/list_pipeline_executions.ts:19-48 (handler)

  The core handler function for the 'list_pipeline_executions' MCP tool. It takes a pipelineName, calls AWS CodePipeline SDK to list executions, formats the response, and returns it as MCP content.

  export async function listPipelineExecutions(codePipelineManager: CodePipelineManager, input: { pipelineName: string }) {
    const { pipelineName } = input;
    const codepipeline = codePipelineManager.getCodePipeline();
    
    const response = await codepipeline.listPipelineExecutions({ 
      pipelineName 
    }).promise();
    
    const executions = response.pipelineExecutionSummaries?.map((execution: AWS.CodePipeline.PipelineExecutionSummary) => ({
      pipelineExecutionId: execution.pipelineExecutionId || '',
      status: execution.status || '',
      startTime: execution.startTime?.toISOString() || '',
      lastUpdateTime: execution.lastUpdateTime?.toISOString() || '',
      sourceRevisions: execution.sourceRevisions?.map((revision: AWS.CodePipeline.SourceRevision) => ({
        name: revision.actionName || '',
        revisionId: revision.revisionId || '',
        revisionUrl: revision.revisionUrl || '',
        revisionSummary: revision.revisionSummary || ''
      })) || []
    })) || [];
  
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify({ executions }, null, 2),
        },
      ],
    };
  }

• src/tools/list_pipeline_executions.ts:4-17 (schema)

  The input schema definition for the 'list_pipeline_executions' tool, specifying the required pipelineName parameter.

  export const listPipelineExecutionsSchema = {
    name: "list_pipeline_executions",
    description: "List executions for a specific pipeline",
    inputSchema: {
      type: "object",
      properties: {
        pipelineName: { 
          type: "string",
          description: "Name of the pipeline"
        }
      },
      required: ["pipelineName"],
    },
  } as const;

• src/index.ts:144-146 (registration)

  Registration of the tool handler in the MCP CallToolRequestHandler switch statement. Dispatches calls to the listPipelineExecutions function.

  case "list_pipeline_executions": {
    return await listPipelineExecutions(codePipelineManager, input as { pipelineName: string });
  }

• src/index.ts:115-115 (registration)

  The tool schema is registered in the ListToolsRequestHandler response, making it discoverable by MCP clients.

  listPipelineExecutionsSchema,

• src/index.ts:20-22 (registration)

  Import statement that brings in the handler and schema from the tools directory.

    listPipelineExecutions, 
    listPipelineExecutionsSchema 
  } from "./tools/list_pipeline_executions.js";