Azure DevOps MCP Server logo

Azure DevOps MCP Server

by aaronsb

This MCP (Model Context Protocol) server provides tools for interacting with Azure DevOps services through AI assistants. It follows an entity-based architecture, grouping operations by resource type for intuitive organization and a consistent interface.

View on GitHub

Last updated: N/A

What is Azure DevOps MCP Server?

The Azure DevOps MCP Server is a tool that facilitates interaction with Azure DevOps services through AI assistants. It provides a structured and consistent way to access and manipulate Azure DevOps resources using a Model Context Protocol.

How to use Azure DevOps MCP Server?

To use the server, you need to configure it with your Azure DevOps organization, project, and Personal Access Token (PAT). You can configure it using environment variables or a configuration file. Once configured, you can send requests to the server to perform operations on Azure DevOps entities like projects, repositories, work items, and pipelines. The server exposes these operations through a set of entity tools.

Key features of Azure DevOps MCP Server

  • Entity-based architecture for intuitive organization

  • Reduced tool count with multiple operations per entity

  • Consistent interface for all entity tools

  • Comprehensive error handling with contextual information

  • Cursor-based pagination for list operations

  • Detailed documentation for tools and operations

Use cases of Azure DevOps MCP Server

  • Automating Azure DevOps tasks using AI assistants

  • Integrating Azure DevOps with other systems

  • Providing a simplified interface for accessing Azure DevOps resources

  • Building custom tools and workflows on top of Azure DevOps

FAQ from Azure DevOps MCP Server

What is an Entity Tool?

An Entity Tool represents a major Azure DevOps entity (e.g., projects, repositories) and provides multiple operations (list, get, create, etc.) for that entity.

How do I configure the server?

The server can be configured using environment variables or a configuration file (config/azuredevops.json). You need to provide your Azure DevOps organization, project, and Personal Access Token (PAT).

What is cursor-based pagination?

Cursor-based pagination allows you to retrieve large datasets in smaller chunks using continuation tokens. This improves performance and reduces resource usage.

What kind of errors does the error handling system catch?

The error handling system categorizes errors by type, including authentication, authorization, validation, rate limit, service, and unknown errors. It also provides contextual information and user-friendly messages.

How do I list projects with pagination?

Use the 'list' operation of the 'Projects Tool' with the 'maxResults' and 'continuationToken' parameters in the request body.