Azure DevOps

What is mcp-azure-devops?

mcp-azure-devops is a Model Context Protocol (MCP) server that enables AI assistants to interact with Azure DevOps services. It acts as a bridge between natural language interactions and the Azure DevOps REST API, allowing AI assistants to query and manage work items, projects, and teams within Azure DevOps.

How to use mcp-azure-devops?

To use mcp-azure-devops, you need Python 3.10+, an Azure DevOps account with appropriate permissions, and a Personal Access Token (PAT). You can install it via pip (pip install mcp-azure-devops) or by cloning the repository and installing in development mode. Configuration involves setting AZURE_DEVOPS_PAT and AZURE_DEVOPS_ORGANIZATION_URL in a .env file. Once configured, you can run the server using mcp dev src/mcp_azure_devops/server.py or install it in Claude Desktop.

Key Features of mcp-azure-devops

Work Item Management:

• Query Work Items: Search using WIQL queries.
• Get Work Item Details: View complete information.
• Create Work Items: Add tasks, bugs, user stories, etc.
• Update Work Items: Modify fields and properties.
• Add/View Comments: Post and retrieve comment history.
• Parent-Child Relationships: Establish hierarchy.

Project Management:

• Get Projects: View accessible projects.
• Get Teams: List teams within the organization.
• Team Members: View team membership.
• Team Area Paths: Retrieve area paths.
• Team Iterations: Access iteration/sprint configurations.

Planned Features:

• Pipeline Operations: Query status and trigger runs.
• Pull Request Handling: Create, update, and review PRs.
• Sprint Management: Plan and manage sprints.
• Branch Policy Administration: Configure and manage policies.

Use Cases of mcp-azure-devops

• Automated Work Item Management: AI assistants can create, update, and query work items based on natural language commands, streamlining project tracking.
• Enhanced Project Visibility: Quickly retrieve project and team information, such as team members, area paths, and iterations, through conversational interfaces.
• Streamlined Development Workflows: Integrate AI assistance directly into Azure DevOps operations, reducing manual effort for common tasks.
• Natural Language Interaction: Developers and project managers can interact with Azure DevOps using natural language, making it more accessible and efficient.

FAQ about mcp-azure-devops

Q: What are the prerequisites for using mcp-azure-devops? A: You need Python 3.10+, an Azure DevOps account with necessary permissions, and a Personal Access Token (PAT).

Q: How do I configure mcp-azure-devops? A: Create a .env file with AZURE_DEVOPS_PAT and AZURE_DEVOPS_ORGANIZATION_URL.

Q: Can I create different types of work items? A: Yes, you can create tasks, bugs, user stories, and other work item types.

Q: What kind of project information can I retrieve? A: You can get all accessible projects, teams, team members, area paths, and team iteration configurations.

Q: Are there plans for pipeline and pull request management? A: Yes, these are planned features for future development.

MCP Azure DevOps Server

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

Overview

This project implements a Model Context Protocol (MCP) server that allows AI assistants (like Claude) to interact with Azure DevOps, providing a bridge between natural language interactions and the Azure DevOps REST API.

Features

Currently implemented:

Work Item Management

• Query Work Items: Search for work items using WIQL queries
• Get Work Item Details: View complete work item information
• Create Work Items: Add new tasks, bugs, user stories, and other work item types
• Update Work Items: Modify existing work items' fields and properties
• Add Comments: Post comments on work items
• View Comments: Retrieve the comment history for a work item
• Parent-Child Relationships: Establish hierarchy between work items

Project Management

• Get Projects: View all accessible projects in the organization
• Get Teams: List all teams within the organization
• Team Members: View team membership information
• Team Area Paths: Retrieve area paths assigned to teams
• Team Iterations: Access team iteration/sprint configurations

Planned features:

• 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.10+
• 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/Vortiago/mcp-azure-devops.git
cd mcp-azure-devops

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

# Install from PyPi
pip install mcp-azure-devops

Configuration

Create a .env file in the project root with the following variables:

AZURE_DEVOPS_PAT=your_personal_access_token
AZURE_DEVOPS_ORGANIZATION_URL=https://your-organization.visualstudio.com or https://dev.azure.com/your-organisation

Note: Make sure to provide the full URL to your Azure DevOps organization.

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

Create a Work Item

Create a user story in the ProjectX with the title "Implement user authentication" and assign it to john.doe@example.com

Update a Work Item

Change the status of bug #1234 to "Resolved" and add a comment explaining the fix

Team Management

Show me all the team members in the "Core Development" team in the "ProjectX" project

View Project Structure

List all projects in my organization and show me the iterations for the Development team

Development

The project is structured into feature modules, each implementing specific Azure DevOps capabilities:

• features/work_items: Work item management functionality
• features/projects: Project management capabilities
• features/teams: Team management features
• utils: Common utilities and client initialization

For more information on development, see the CLAUDE.md file.

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