Azure DevOps Pipeline MCP

Complete MCP (Model Context Protocol) server for intelligent Azure DevOps CI/CD pipeline generation using Auggie AI. This package provides everything needed for repositories to automatically generate, validate, and register Azure DevOps pipelines.

Installation

npm install @wexinc/azure-devops-pipeline-mcp

Quick Setup

1. Install and Setup MCP Server

# Install the package
npm install @wexinc/azure-devops-pipeline-mcp

# Copy MCP configuration to your repo
cp -r node_modules/@wexinc/azure-devops-pipeline-mcp/.mcp ./
cp -r node_modules/@wexinc/azure-devops-pipeline-mcp/.github ./

2. Configure GitHub Secrets

Add these secrets to your GitHub repository:

• AZURE_DEVOPS_PAT: Azure DevOps Personal Access Token with Build: Read & Execute permissions
• AUGMENT_SESSION_AUTH: Auggie authentication token from your Auggie account

3. Run Intelligent Pipeline Generation

Go to GitHub Actions → "MCP Server Pipeline Generator (Auggie)" → "Run workflow"

Auggie will complete all 5 phases automatically:

1. Analyze your repository structure
2. Suggest appropriate pipeline templates based on project type
3. Generate both CI and CD pipeline files (*-az-ci.yml, *-az-cd.yml)
4. Create a pull request with both pipelines
5. Register pipelines in Azure DevOps immediately (no waiting for PR approval)

Generated Files:

• .azuredevops/{repo-name}-az-ci.yml - CI pipeline
• .azuredevops/{repo-name}-az-cd.yml - CD pipeline with deployment stages

Alternative: Direct CLI Usage

# Generate pipelines without Auggie (basic mode)
npx @wexinc/azure-devops-pipeline-mcp

What It Does

1. Analyzes your .NET repository structure
2. Detects application type (ASP.NET, Windows Service, etc.)
3. Generates appropriate CI pipeline YAML files
4. Generates CD pipeline YAML files with deployment stages
5. Creates .azuredevops/ directory with pipeline files
6. Registers pipelines as actual build definitions in Azure DevOps (via Auggie workflow)
7. Creates pull requests with generated pipeline files (via Auggie workflow)

Generated Files

• .azuredevops/your-repo-ci.yml - CI pipeline
• .azuredevops/your-repo-cd.yml - CD pipeline

Supported Project Types

• ASP.NET Web Applications - Uses aspnet-iis-ci-template.yml
• Windows Services - Uses dotnet-winsvc-sc-ci-template.yml
• NuGet Packages - Uses dotnet-nuget-ci-template.yml
• Visual Studio Tools/Libraries - Uses vs-tool-ci-template.yml

Requirements

• Python 3.11+ (for MCP server)
• Node.js 18+ (for Auggie and NPM)
• .NET project with .csproj or .sln files
• Azure DevOps organization access with pipeline creation permissions
• GitHub repository with Actions enabled

Command Line Options

# Generate in current directory
npx @wexinc/azure-devops-pipeline-mcp

# Specify repository path
npx @wexinc/azure-devops-pipeline-mcp --repo-path=/path/to/repo

Example Output

After running the command, you'll see:

Starting Azure DevOps Pipeline Generator...
Working directory: /your/project/path
Repository path: /your/project/path
[ok] Written pipeline to: /your/project/.azuredevops/your-repo-ci.yml
[ok] Written pipeline to: /your/project/.azuredevops/your-repo-cd.yml
Generated 2 pipeline file(s):
   your-repo-ci.yml
   your-repo-cd.yml
Pipeline generation completed!

License

MIT