Azure DevOps MCP Server

A READ-ONLY MCP (Model Context Protocol) server that connects AI assistants to Azure DevOps Server (on-premises). Works with Claude Code CLI, VS Code AI extensions (Continue, Cline), Cursor, and any MCP-compatible client.

Features

• Projects: List and explore projects
• Git/Repos: Browse repositories, commits, branches, pull requests, diffs, and code search
• Builds: List builds, view logs, analyze errors
• Work Items: Query work items, find linked commits/PRs
• Releases: View releases and deployment status
• Pipelines: List YAML pipelines, view runs, get pipeline configuration
• Test Results: View test runs, results, and analyze failures

Prerequisites

• Node.js 18 or higher
• Azure DevOps Server 2020 or 2022 (on-premises)
• Personal Access Token (PAT) with read scopes

Installation

Option 1: npm (Recommended)

npx azure-devops-mcp@latest

Option 2: Clone and Build

git clone https://github.com/elad-nofy/azure-devops-mcp.git
cd azure-devops-mcp
npm install
npm run build

Configuration

Create a Personal Access Token (PAT)

1. Go to Azure DevOps Server
2. Click on your profile icon > Security > Personal access tokens
3. Create a new token with the following scopes:
   • Code: Read
   • Build: Read
   • Work Items: Read
   • Release: Read
   • Test Management: Read

Configure MCP Client

Claude Code CLI

Add to your global settings (~/.claude.json on macOS/Linux, %USERPROFILE%\.claude.json on Windows):

Windows:

{
  "mcpServers": {
    "azure-devops": {
      "command": "cmd",
      "args": ["/c", "npx", "azure-devops-mcp"],
      "env": {
        "AZURE_DEVOPS_URL": "http://your-tfs-server:8080/tfs",
        "AZURE_DEVOPS_PAT": "your-personal-access-token",
        "AZURE_DEVOPS_COLLECTION": "YourCollection",
        "AZURE_DEVOPS_PROJECT": "YourDefaultProject"
      }
    }
  }
}

macOS / Linux:

{
  "mcpServers": {
    "azure-devops": {
      "command": "npx",
      "args": ["azure-devops-mcp"],
      "env": {
        "AZURE_DEVOPS_URL": "http://your-tfs-server:8080/tfs",
        "AZURE_DEVOPS_PAT": "your-personal-access-token",
        "AZURE_DEVOPS_COLLECTION": "YourCollection",
        "AZURE_DEVOPS_PROJECT": "YourDefaultProject"
      }
    }
  }
}

VS Code (Continue/Cline)

Add similar configuration to the extension's MCP settings.

Environment Variables

| Variable | Required | Description | |----------|----------|-------------| | AZURE_DEVOPS_URL | Yes | Server base URL (e.g., http://tfs:8080/tfs) | | AZURE_DEVOPS_PAT | Yes | Personal Access Token | | AZURE_DEVOPS_COLLECTION | No | Collection name (default: DefaultCollection) | | AZURE_DEVOPS_PROJECT | No | Default project for commands |

Available Tools

Projects

| Tool | Description | |------|-------------| | test_connection | Test connection to Azure DevOps and verify authentication | | list_projects | List all projects in the organization | | get_project | Get detailed project information |

Git / Repositories

| Tool | Description | |------|-------------| | list_repos | List repositories in a project | | list_branches | List branches in a repository | | list_commits | Get commit history with filters | | get_commit | Get commit details with changes | | get_commit_diff | Get file diff for a commit | | list_pull_requests | List pull requests | | get_pull_request | Get PR details with comments | | compare_branches | Compare two branches (regression analysis) | | search_code | Search for text in repository files | | get_file_content | Get file content from a repo at a specific branch/commit | | get_commits_for_work_item | Find commits referencing a work item | | get_prs_for_work_item | Find PRs linked to a work item |

Builds

| Tool | Description | |------|-------------| | list_builds | List recent builds | | get_build | Get build details | | get_build_logs | Get build logs | | list_build_definitions | List build definitions | | analyze_build_errors | Extract errors from failed builds |

Work Items

| Tool | Description | |------|-------------| | query_work_items | Search work items (WIQL or filters) | | get_work_item | Get work item details | | list_work_item_types | List available work item types | | list_iterations | List iterations/sprints in a project | | list_areas | List area paths in a project |

Releases

| Tool | Description | |------|-------------| | list_releases | List releases | | get_release | Get release details | | list_release_definitions | List release definitions | | get_release_logs | Get deployment logs |

Pipelines

| Tool | Description | |------|-------------| | list_pipelines | List YAML pipelines | | get_pipeline_runs | Get recent pipeline runs | | get_pipeline_yaml | Get pipeline YAML configuration | | get_pipeline_variables | Get pipeline variables |

Test Results

| Tool | Description | |------|-------------| | list_test_runs | List test runs in a project | | get_test_run | Get test run details | | get_test_results | Get test results from a run | | get_failed_tests | Get failed tests from a run | | get_test_runs_for_build | Get test runs for a specific build | | analyze_test_failures | Analyze and group test failures |

Usage Examples

Once configured, you can ask your AI assistant questions like:

• "Show me the recent builds for project X"
• "What's the status of PR #123?"
• "List all bugs assigned to me"
• "Show me the commits from last week"
• "Why did build #456 fail?"
• "What tests failed in build #789?"
• "Compare branches Dev/9.1 and Dev/9.2"
• "Search for 'IMediator' in the Controllers folder"

Development

# Install dependencies
npm install

# Build
npm run build

# Watch mode
npm run dev

Troubleshooting

Connection errors

• Verify AZURE_DEVOPS_URL is correct and accessible
• Check if your PAT has not expired
• Ensure your network allows connection to the server

Permission errors

• Verify PAT has required scopes
• Check if you have access to the project/repository

"Project is required" errors

• Set AZURE_DEVOPS_PROJECT environment variable, or
• Pass project parameter in tool calls

License

MIT