Azure DevOps MCP Server

An MCP (Model Context Protocol) server that provides 69 tools for interacting with Azure DevOps. Supports both local Claude Desktop integration and remote deployment to Azure Functions.

Features

• Projects & Teams: List projects, teams, and team members
• Work Items: Full CRUD, batch updates, linking, comments, backlogs
• Git Repositories: Repos, branches, commits, file content
• Pull Requests: Create, update, reviewers, threads, comments
• Pipelines & Builds: List, trigger, monitor, logs, stages
• Iterations & Areas: Sprint management, capacity planning
• Wikis: List, read, and create/update wiki pages
• Test Plans: Plans, suites, test cases, results
• Search: Code, work items, and wiki search
• Advanced Security: Security alerts and details

Deployment Options

Option 1: Local (Claude Desktop with Browser Auth)

Run locally with interactive browser authentication - best for personal use.

Option 2: Azure Functions (Serverless)

Deploy to Azure Functions for a hosted solution - best for teams and sharing.

Option 3: Remote Bridge (Claude Desktop → Azure Functions)

Connect Claude Desktop to a hosted Azure Functions instance.

Quick Start: Local Setup

1. Clone and Install

git clone https://github.com/YOUR_USERNAME/dami-ado-mcp-server.git
cd dami-ado-mcp-server
npm install
npm run build

2. Configure Environment

cp .env.example .env

Edit .env:

AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-org
# Leave AZURE_DEVOPS_PAT empty to use browser authentication

3. Add to Claude Desktop

Add to your claude_desktop_config.json:

Windows: %APPDATA%\Claude\claude_desktop_config.json macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["C:\\path\\to\\dami-ado-mcp-server\\dist\\index.js"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-org"
      }
    }
  }
}

4. Restart Claude Desktop

A browser window will open for authentication on first use.

Azure Functions Deployment

1. Prerequisites

• Azure CLI installed and logged in (az login)
• Azure Functions Core Tools (npm install -g azure-functions-core-tools@4)

2. Create Azure Resources

# Create resource group
az group create --name my-ado-mcp-rg --location eastus

# Create storage account
az storage account create --name myadomcpstorage --location eastus \
  --resource-group my-ado-mcp-rg --sku Standard_LRS

# Create function app
az functionapp create --resource-group my-ado-mcp-rg \
  --consumption-plan-location eastus --runtime node --runtime-version 20 \
  --functions-version 4 --name my-ado-mcp-server \
  --storage-account myadomcpstorage

3. Configure Settings

# Set Azure DevOps org URL
az functionapp config appsettings set --name my-ado-mcp-server \
  --resource-group my-ado-mcp-rg \
  --settings AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-org

# Set PAT token (required for serverless)
az functionapp config appsettings set --name my-ado-mcp-server \
  --resource-group my-ado-mcp-rg \
  --settings AZURE_DEVOPS_PAT=your-pat-token

4. Deploy

npm run build
func azure functionapp publish my-ado-mcp-server

5. Get Function Key

az functionapp keys list --name my-ado-mcp-server --resource-group my-ado-mcp-rg

6. Test Endpoints

# Health check (no auth)
curl https://my-ado-mcp-server.azurewebsites.net/api/health

# List tools (no auth)
curl https://my-ado-mcp-server.azurewebsites.net/api/tools

# Call MCP endpoint (with function key)
curl -X POST "https://my-ado-mcp-server.azurewebsites.net/api/mcp?code=YOUR_FUNCTION_KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"list_projects","arguments":{}},"id":1}'

Remote Bridge: Claude Desktop → Azure Functions

Use the remote bridge to connect Claude Desktop to your hosted Azure Functions instance.

Configure Claude Desktop

{
  "mcpServers": {
    "azure-devops-remote": {
      "command": "node",
      "args": ["C:\\path\\to\\dami-ado-mcp-server\\dist\\remote-bridge.js"],
      "env": {
        "MCP_REMOTE_URL": "https://my-ado-mcp-server.azurewebsites.net/api/mcp",
        "MCP_FUNCTION_KEY": "your-function-key"
      }
    }
  }
}

Authentication Methods

1. Interactive Browser (Local)

Best for personal use. Leave AZURE_DEVOPS_PAT empty and a browser window will open for login.

2. PAT Token (Serverless/Shared)

Required for Azure Functions. Create a PAT at: https://dev.azure.com/your-org/_usersSettings/tokens

Required scopes:

• Code: Read & Write
• Work Items: Read & Write
• Build: Read & Execute
• Project and Team: Read
• Wiki: Read & Write
• Test Management: Read & Write

Available Tools (69)

Projects & Teams

Work Items

Git & Repositories

Pull Requests

Pipelines & Builds

Iterations & Capacity

Areas

Wikis

Test Plans

Search

Identity

Boards & Queries

Security

API Endpoints (Azure Functions)

MCP Protocol Examples

# List tools
curl -X POST "https://YOUR_APP.azurewebsites.net/api/mcp?code=KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1}'

# Call a tool
curl -X POST "https://YOUR_APP.azurewebsites.net/api/mcp?code=KEY" \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","method":"tools/call","params":{"name":"list_projects","arguments":{}},"id":1}'

Development

# Install dependencies
npm install

# Build
npm run build

# Run local MCP server (stdio)
npm start

# Run HTTP server (standalone)
npm run start:http

# Run Azure Functions locally
npm run start:func

License

MIT