MCP Azure DevOps Server

A Model Context Protocol (MCP) server enabling AI assistants to interact with Azure DevOps services.

Overview

This project implements an MCP server, acting as a bridge between AI assistants and Azure DevOps. It allows natural language interactions to be translated into Azure DevOps REST API calls.

Features

Currently implemented:

• Work Item Management: Query work items using WIQL

Planned features:

• Work Item Management: Create and update work items
• Pipeline Operations: Query pipeline status and trigger new pipeline runs
• Pull Request Handling: Create, update, and review Pull Requests
• Sprint Management: Plan and manage sprints and iterations
• Branch Policy Administration: Configure and manage branch policies

Getting Started

Prerequisites

• Python 3.9+
• Azure DevOps account with appropriate permissions
• Personal Access Token (PAT) with necessary scopes for Azure DevOps API access

Installation

# Clone the repository
git clone https://github.com/your-username/mcp-azure-devops.git
cd mcp-azure-devops

# Install in development mode
pip install -e ".[dev]"

# Install from PyPi
pip install mcp_azure_devops

Configuration

Create a .env file in the project root with AZURE_DEVOPS_PAT and AZURE_DEVOPS_ORGANIZATION_URL variables.

Running the Server

# Development mode with the MCP Inspector
mcp dev src/mcp_azure_devops/server.py

# Install in Claude Desktop
mcp install src/mcp_azure_devops/server.py --name "Azure DevOps Assistant"

Usage Examples

Query Work Items

Show me all active bugs assigned to me in the current sprint

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• Built with MCP Python SDK
• Uses Azure DevOps Python API