Azure DevOps MCP Server

MCP server for Azure DevOps - manage pull requests, work items, pipelines, and variable groups via Claude.

Features

13 tools across 4 categories:

• Pull Requests (3 tools): create, list, get details
• Work Items (3 tools): query, get, create
• Pipelines (4 tools): list, run, check status, cancel
• Variable Groups (3 tools): list, get, update variables

Quick Start

For Claude Desktop Users

Want to use this with Claude Desktop? See the Claude Desktop Setup Guide for step-by-step instructions.

For Development/Testing

# 1. Clone repository
git clone <repo-url>
cd azure-devops-mcp

# 2. Set up project
make setup

# 3. Configure environment variables
export AZURE_DEVOPS_EXT_PAT="your-pat-token"
export AZURE_DEVOPS_ORG="https://dev.azure.com/your-org"
export AZURE_DEVOPS_PROJECT="your-project"

# 4. Run the server
make run

Documentation

• Claude Desktop Setup - Use with Claude Desktop app
• Setup Guide - Installation and configuration for development
• Tool Reference - Complete tool documentation
• Troubleshooting - Common issues and solutions

Requirements

• Python 3.11+
• Azure CLI 2.30.0+ with DevOps extension
• Azure DevOps Personal Access Token with required scopes:
  • Code: Read & Write
  • Work Items: Read & Write
  • Build: Read & Execute
  • Release: Read, Write & Execute

Development

Commands

make setup       # Bootstrap project (create venv, install deps)
make lint        # Lint and format code
make test        # Run unit tests
make test-e2e    # Run end-to-end tests (requires Azure DevOps)
make dev         # Launch MCP Inspector for interactive testing
make run         # Run server

Project Structure

azure-devops-mcp/
├── src/
│   └── azure_devops_mcp/
│       ├── server.py              # FastMCP entry point
│       ├── tools/                 # 13 tools
│       │   ├── pull_requests.py   # PR tools
│       │   ├── work_items.py      # Work item tools
│       │   ├── pipelines.py       # Pipeline tools
│       │   └── variable_groups.py # Variable group tools
│       ├── utils/                 # Core utilities
│       │   ├── azure_cli.py       # Azure CLI executor
│       │   ├── context.py         # Context manager
│       │   ├── errors.py          # Error handler
│       │   └── formatters.py      # Response formatters
│       └── schemas/
│           └── models.py          # Pydantic input models
├── tests/                         # Test suite
├── docs/                          # Documentation
├── pyproject.toml                 # Dependencies & config
└── Makefile                       # Development commands

License

MIT