Azure DevOps MCP Server

Instructions

Implementation Reference

• src/features/pipelines/get-pipeline/feature.ts:16-73 (handler)

  The main handler function 'getPipeline' that executes the tool logic, fetching pipeline details from Azure DevOps API.

  export async function getPipeline(
    connection: WebApi,
    options: GetPipelineOptions,
  ): Promise<Pipeline> {
    try {
      const pipelinesApi = await connection.getPipelinesApi();
      const { projectId, pipelineId, pipelineVersion } = options;
  
      // Call the pipelines API to get the pipeline
      const pipeline = await pipelinesApi.getPipeline(
        projectId,
        pipelineId,
        pipelineVersion,
      );
  
      // If pipeline not found, API returns null instead of throwing error
      if (pipeline === null) {
        throw new AzureDevOpsResourceNotFoundError(
          `Pipeline not found with ID: ${pipelineId}`,
        );
      }
  
      return pipeline;
    } catch (error) {
      // Handle specific error types
      if (error instanceof AzureDevOpsError) {
        throw error;
      }
  
      // Check for specific error types and convert to appropriate Azure DevOps errors
      if (error instanceof Error) {
        if (
          error.message.includes('Authentication') ||
          error.message.includes('Unauthorized') ||
          error.message.includes('401')
        ) {
          throw new AzureDevOpsAuthenticationError(
            `Failed to authenticate: ${error.message}`,
          );
        }
  
        if (
          error.message.includes('not found') ||
          error.message.includes('does not exist') ||
          error.message.includes('404')
        ) {
          throw new AzureDevOpsResourceNotFoundError(
            `Pipeline or project not found: ${error.message}`,
          );
        }
      }
  
      // Otherwise, wrap it in a generic error
      throw new AzureDevOpsError(
        `Failed to get pipeline: ${error instanceof Error ? error.message : String(error)}`,
      );
    }
  }

• src/features/pipelines/get-pipeline/schema.ts:7-28 (schema)

  Zod schema defining the input parameters for the 'get_pipeline' tool: projectId, pipelineId, pipelineVersion.

  export const GetPipelineSchema = z.object({
    // The project containing the pipeline
    projectId: z
      .string()
      .optional()
      .describe(`The ID or name of the project (Default: ${defaultProject})`),
    // The ID of the pipeline to retrieve
    pipelineId: z
      .number()
      .int()
      .positive()
      .describe('The numeric ID of the pipeline to retrieve'),
    // The version of the pipeline to retrieve
    pipelineVersion: z
      .number()
      .int()
      .positive()
      .optional()
      .describe(
        'The version of the pipeline to retrieve (latest if not specified)',
      ),
  });

• src/features/pipelines/tool-definitions.ts:22-27 (registration)

  Registration of the 'get_pipeline' tool in the pipelinesTools array, including name, description, and input schema.

  {
    name: 'get_pipeline',
    description: 'Get details of a specific pipeline',
    inputSchema: zodToJsonSchema(GetPipelineSchema),
    mcp_enabled: true,
  },