🚀 Azure DevOps MCP Server

A custom Model Context Protocol (MCP) server built with NestJS, enabling AI agents (like Claude Desktop) to securely query Azure DevOps data such as work items, projects, and ticket statistics.

📌 Overview

This project exposes Azure DevOps data through a standards-based MCP server, allowing any MCP-compatible AI agent to perform real-time queries such as:

🔍 List all projects in the organization
📝 Get count of created / active / closed work items
🧩 Fetch ticket details
📊 Query backlog items or sprints
🏗️ Extend Azure DevOps automation through AI

It supports two modes:

1️⃣ STDIO MCP Server

Tested locally using the MCP Inspector (not using a direct Claude Desktop STDIO client).

2️⃣ HTTP MCP Server

Allows remote access using MCP-over-HTTP.

🏗️ Architecture

NestJS Application
│
├── MCP Module
│   ├── Tool Definitions
│   ├── STDIO Transport
│   └── HTTP Transport
│
├── Azure DevOps Service
│   └── Work Item API
│   └── Project API
│
└── Utilities
    ├── MCP Message Handlers
    └── Logger

✨ Features

✔️ Custom Tools for Azure DevOps

Tools exposed to MCP clients:

Tool Name	Description
`list_projects`	Returns all Azure DevOps projects
`count_tickets`	Returns summary of created/active/resolved tickets
`get_workitem`	Fetch details of a single work item
`search_workitems`	Query work items based on filters

✔️ STDIO Transport (MCP Inspector)

This project was tested locally using the MCP Inspector, which acts as an MCP client that connects over STDIO to your server.

Run the server so the inspector can connect over STDIO:

node dist/main.js

Start the inspector with:

npx @modelcontextprotocol/inspector

When prompted in the inspector, choose the STDIO connection and point it at the running process (the inspector will spawn or attach to the process as configured).

✔️ HTTP MCP Support

Start server:

npm run start:prod

You can POST MCP-style requests:

POST http://localhost:3000/mcp

🔧 Installation

git clone https://github.com/saktheeswar/Azure_Devops_MCP_Server.git
cd azure-devops-mcp
npm install
npm run build

🔑 Environment Variables

Create .env:

BASE_URL=url
AUSER_NAME=your-personal-access-token
ADO_PAT=your-default-project

▶️ Running the Server

Run in STDIO mode (for MCP Inspector)

node dist/main.js

Run in HTTP mode

npm run start:prod

🧪 Testing with MCP Inspector

(You will explain this with screenshots in your blog.)

npx @modelcontextprotocol/inspector

Then connect using STDIO:

node dist/main.js

💻 Code Walkthrough

📁 MCP Server Setup

const server = new Server({
  name: "azure-devops-mcp",
  version: "1.0.0",
  tools: {
    list_projects: { ... },
    count_tickets: { ... }
  }
});

📁 Azure DevOps API Integration

async getProjects() {
  const url = `${this.baseUrl}/projects?api-version=7.0`;
  return this.http.get(url, this.headers);
}

📁 STDIO Bootstrap

bootstrapStdio(server);

📁 HTTP Controller

@Post('/mcp')
handleMcp(@Body() body) {
  return this.mcpHttpService.process(body);
}

📚 Example MCP Tool Call

{
  "method": "tools/list_projects",
  "params": {}
}

Response:

{
  "projects": [
    { "name": "Frontend" },
    { "name": "Backend" },
    { "name": "Infrastructure" }
  ]
}

🧩 Use Cases

For Developers

Query Azure DevOps without opening the UI
Get ticket summaries instantly
Automate repetitive DevOps activities

For AI Assistants

Smart sprint planning
Ticket prioritization
Automated status reporting

For Teams

Faster decision making
AI-powered insights

🔥 Future Enhancements

Create/Update work items using AI
Integration with Release Pipelines
Sprint burndown insights
PR and Repository analytics

📎 Screenshots (Add your own)

Claude Desktop working
MCP Inspector connected
Tool response logs

🧑‍💻 Author

Saktheeswaran M AI Engineer & Full-Stack Developer

🔗 Source Code

👉 GitHub Repository: (https://github.com/saktheeswar/Azure_Devops_MCP_Server)