Skip to main content
Glama
MCP Server for Azure DevOps

MCP Server for Azure DevOps

by sepal7

MCP Server for Azure DevOps

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

License: MIT Node.js

πŸš€ Quick Install

# Clone the repository
git clone https://github.com/sepal7/mcp-ado.git
cd mcp-ado

# Install dependencies
npm install

# Create .env file
cp .env.example .env
# Edit .env with your Azure DevOps credentials

# Test the connection
npm run test-connection

Then configure your IDE (see Installation section below).

Related MCP server: Azure DevOps MCP Server

πŸ“¦ 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

Feature

This Project

Other MCP ADO Servers

Total Tools

25+

5-15

Wiki Support

βœ… Yes (3 tools)

❌ Limited/None

Multi-Project

βœ… Built-in

❌ Single project

WIQL Queries

βœ… Yes

❌ No

Generic API Tool

βœ… Yes

❌ No

Helper Scripts

βœ… PAT management

❌ No

Documentation

βœ… Comprehensive

⚠️ Basic

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

# Clone the repository
git clone https://github.com/sepal7/mcp-ado.git
cd mcp-ado

# Install dependencies
npm install

# Create .env file
cp .env.example .env
# Edit .env with your values:
# AZURE_DEVOPS_ORG=YourOrganization
# AZURE_DEVOPS_PROJECT=YourProject
# AZURE_DEVOPS_PAT=your_pat_token_here

# Test the connection
npm run test-connection

Then configure manually (see detailed guides below).

For detailed setup instructions, see:

🎯 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

Variable

Required

Description

AZURE_DEVOPS_ORG

Yes

Your Azure DevOps organization name

AZURE_DEVOPS_PROJECT

Yes

Default project name

AZURE_DEVOPS_PAT

Yes

Personal Access Token

APPLICATIONINSIGHTS_CONNECTION_STRING

No

Optional telemetry connection string

Multi-Project Support

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

"List repositories in the [ProjectName] project"

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

πŸ“ Project Structure

mcp-ado/
β”œβ”€β”€ server.js              # Main MCP server implementation
β”œβ”€β”€ package.json           # Node.js dependencies and scripts
β”œβ”€β”€ .env.example           # Environment variables template
β”œβ”€β”€ README.md              # This file
β”‚
β”œβ”€β”€ docs/                  # Documentation
β”‚   β”œβ”€β”€ 01-SETUP.md        # General setup guide
β”‚   β”œβ”€β”€ 02-CURSOR-SETUP.md # Cursor IDE setup
β”‚   β”œβ”€β”€ 03-VSCODE-SETUP.md # VS Code setup
β”‚   β”œβ”€β”€ 04-PAT-MANAGEMENT.md # PAT token management
β”‚   β”œβ”€β”€ 05-RESTART-SERVER.md # How to restart server
β”‚   β”œβ”€β”€ 07-CHANGELOG.md     # Version history
β”‚   └── 08-ONPREMISE-WINDOWS-IIS.md # On-premise deployment
β”‚
β”œβ”€β”€ scripts/               # Utility scripts
β”‚   β”œβ”€β”€ test.js            # Basic server tests
β”‚   β”œβ”€β”€ test-connection.js # Azure DevOps connection tester
β”‚   └── update-pat.ps1     # PAT token updater script
β”‚
└── azure/                 # Azure deployment files
    β”œβ”€β”€ README.md          # Azure deployment guide
    β”œβ”€β”€ Dockerfile         # Container image definition
    └── azure-deploy.bicep # Infrastructure as code

πŸ“š Documentation

🀝 Contributing

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

πŸ“„ License

MIT License - see LICENSE file for details

πŸ™ Credits


Made with ❀️ for the MCP community

Available Tools

25 tools
ado_api_callC

Make a generic Azure DevOps REST API call

Inputs: endpoint (required), project, method, params, +1 more.

create_work_itemC

Create a new work item

Inputs: type (required), title (required), project, description, +1 more.

get_buildC

Get build details by ID

Inputs: buildId (required), project.

get_pipeline_runC

Get pipeline run details

Inputs: pipelineId (required), runId (required), project.

get_pr_commentsC

Get pull request review comments

Inputs: repo (required), pullRequestId (required), project, $top.

get_pull_requestC

Get pull request details

Inputs: repo (required), pullRequestId (required), project, includeCommits, +1 more.

get_releaseC

Get release details

Inputs: releaseId (required), project.

get_repoB

Get repository details by name

Inputs: repo (required), project.

get_repo_fileC

Get file content from a repository

Inputs: repo (required), path (required), project, branch, +1 more.

get_test_planC

Get test plan details

Inputs: planId (required), project.

get_wiki_pageC

Retrieve a specific Azure DevOps wiki page by ID or path

Inputs: project, wiki, pageId, path, +1 more.

get_work_itemC

Get work item details by ID

Inputs: workItemId (required), project, fields, expand.

get_work_itemsC

Get multiple work items by IDs

Inputs: workItemIds (required), project, fields, expand.

list_buildsC

List recent builds

Inputs: project, definitionId, status, result, +1 more.

list_pipelinesC

List pipelines in the project

Inputs: project, $top.

list_pull_requestsC

List pull requests in a repository

Inputs: repo (required), project, status, $top.

list_releasesD

List releases

Inputs: project, definitionId, status, $top.

list_repo_branchesC

List branches in a repository

Inputs: repo (required), project, includeLinks.

list_reposC

List all repositories in the project

Inputs: project, includeLinks.

list_test_plansC

List test plans

Inputs: project, $top.

list_wiki_pagesC

List all pages in a wiki

Inputs: project, wiki, recursive.

query_work_itemsC

Query work items using WIQL (Work Item Query Language)

Inputs: wiql (required), project, $top.

search_codeC

Search code across repositories

Inputs: searchText (required), project, repo, $top.

search_wiki_pagesC

Search wiki pages by content or title

Inputs: query (required), project, wiki.

update_work_itemC

Update an existing work item

Inputs: workItemId (required), project, fields, links, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    C2.9/5.0

    Scored across 25 tools

    Disambiguation4/5

    Most tools have distinct purposes targeting specific Azure DevOps resources (e.g., work items, builds, pipelines, repos, wikis), with clear separation between get/list/query/search operations. However, some potential confusion exists between get_work_item and get_work_items (both retrieve work items, differing only in single vs. multiple items), and between list_wiki_pages and search_wiki_pages (both operate on wiki pages with overlapping retrieval functions).

    Naming Consistency5/5

    Tool names follow a highly consistent verb_noun pattern throughout, using snake_case uniformly. Verbs are standardized (get, list, create, update, query, search) paired with specific nouns (work_item, build, pipeline, repo, wiki_page, etc.), making the naming predictable and easy to understand. No deviations or mixed conventions are present.

    Tool Count3/5

    With 25 tools, the count is borderline high for a single server, potentially overwhelming for agents. While Azure DevOps is a broad platform, the toolset covers multiple domains (work items, CI/CD, repos, wikis, testing), which might be better split into focused servers. However, the tools are well-organized within this scope, avoiding extreme bloat.

    Completeness4/5

    The toolset provides comprehensive coverage for core Azure DevOps operations, including CRUD for work items (create, get, update, query), listing and retrieving builds, pipelines, releases, repos, and wikis, and search capabilities for code and wiki pages. Minor gaps include missing update/delete operations for non-work-item resources (e.g., no update_build or delete_repo) and limited pull request management (only get and list, no create or merge), but agents can work around these with the generic ado_api_call.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers