MCP Server for Azure DevOps

A comprehensive Model Context Protocol (MCP) server that provides AI assistants with full access to Azure DevOps services.

🚀 Quick Install

Then configure your IDE (see Installation section below).

📦 Available Tools (25+)

Wiki (3 tools)

• get_wiki_page - Retrieve wiki page by ID or path

• list_wiki_pages - List all wiki pages in a project

• search_wiki_pages - Search wiki pages by content or title

Repositories (5 tools)

• list_repos - List all repositories

• get_repo - Get repository details

• get_repo_file - Get file content from repository

• list_repo_branches - List branches in a repository

• search_code - Search code across repositories

Work Items (5 tools)

• get_work_item - Get work item by ID

• get_work_items - Get multiple work items

• query_work_items - Query work items using WIQL

• create_work_item - Create new work item

• update_work_item - Update existing work item

Pull Requests (3 tools)

• list_pull_requests - List pull requests

• get_pull_request - Get pull request details

• get_pr_comments - Get PR review comments

Builds & Pipelines (4 tools)

• list_builds - List recent builds

• get_build - Get build details

• list_pipelines - List pipelines

• get_pipeline_run - Get pipeline run details

Releases (2 tools)

• list_releases - List releases

• get_release - Get release details

Test Plans (2 tools)

• list_test_plans - List test plans

• get_test_plan - Get test plan details

Generic (1 tool)

• ado_api_call - Make any Azure DevOps REST API call

🌟 Comparison with Similar Projects

Key Differentiators:

• Most comprehensive tool coverage (25+ vs 5-15)

• Multi-project support without reconfiguration

• Advanced features (WIQL queries, generic API tool)

• Better developer experience (helper scripts, comprehensive docs)

✨ Features

• 25+ MCP Tools covering all major Azure DevOps services

• Multi-Project Support - Access any project in your organization without reconfiguration

• WIQL Query Support - Advanced work item querying using Work Item Query Language

• Generic API Tool - Make any Azure DevOps REST API call for future-proof extensibility

• Helper Scripts - Automated PAT token management and connection testing

• Comprehensive Documentation - Step-by-step guides for Cursor, VS Code, and deployment

🚀 Quick Start

Prerequisites

• Node.js 18+ installed

• Azure DevOps Personal Access Token (PAT) with appropriate permissions

• VS Code with GitHub Copilot Chat extension, VS Code Insiders, or Cursor IDE

Installation

📦 Install from Source

Then configure manually (see detailed guides below).

For detailed setup instructions, see:

• Cursor Setup Guide

• VS Code Setup Guide

🎯 Usage Examples

Once configured, use natural language to interact with Azure DevOps:

Default Project:

• "List all repositories"

• "Get work item #12345"

• "Show me pull requests"

Other Projects:

• "List repositories in the [ProjectName] project"

• "Get work items from the [ProjectName] project"

All tools support an optional project parameter to access any project in your organization.

⚙️ Configuration

Environment Variables

Multi-Project Support

All MCP tools support an optional project parameter. When using Cursor or VS Code, mention the project name in your request:

The AI assistant automatically extracts the project name and passes it to the MCP tool.

📁 Project Structure

📚 Documentation

• Setup Guide - General setup and configuration

• Cursor Setup - Cursor IDE configuration

• VS Code Setup - VS Code + GitHub Copilot setup

• PAT Management - Managing Personal Access Tokens

• Changelog - Version history

🤝 Contributing

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

📄 License

MIT License - see LICENSE file for details

🙏 Credits

• Enhanced with features from Microsoft's official Azure DevOps MCP Server

Made with ❤️ for the MCP community