Azure DevOps MCP Server

by aymenfurter

261 downloads
Not rated
GitHub

Description

# Azure DevOps MCP Server This is a Model Context Protocol (MCP) server for Azure DevOps that provides work item management capabilities. ## Prerequisites - Docker - Azure DevOps Personal Access Token (PAT) with appropriate permissions - Azure DevOps Organization and Project…

About

# Azure DevOps MCP Server This is a Model Context Protocol (MCP) server for Azure DevOps that provides work item management capabilities. ## Prerequisites - Docker - Azure DevOps Personal Access Token (PAT) with appropriate permissions - Azure DevOps Organization and Project details ## Quick Start 1. Build the Docker…

Details

Author
aymenfurter
Downloads
261
Categories
Cloud Service

- Search existing work items
- Create new work items
- Update existing work items
- Retrieve work item states
- Simple command-line interface for testing

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Azure DevOps MCP Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Build the Docker image with docker build -t ado-mcp-server . then run the container with three environment variables: ADO_PERSONAL_ACCESS_TOKEN, ADO_ORGANIZATION_URL, and ADO_PROJECT_NAME. For VS Code integration, add the provided JSON configuration to your editor settings.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "azure devops mcp server": {
            "ado-mcp-server-python": {
                "command": "docker",
                "args": [
                    "build",
                    "-t",
                    "ado-mcp-server",
                    "."
                ]
            }
        }
    }
}

McpServers

{
    "ado-mcp-server-python": {
        "command": "docker",
        "args": [
            "build",
            "-t",
            "ado-mcp-server",
            "."
        ]
    }
}

Azure DevOps MCP Server

This is a Model Context Protocol (MCP) server for Azure DevOps that provides work item management capabilities.

Prerequisites

- Docker
- Azure DevOps Personal Access Token (PAT) with appropriate permissions
- Azure DevOps Organization and Project details

Quick Start

1. Build the Docker image:

docker build -t ado-mcp-server .

2. Run the server with environment variables:

docker run -i --rm \
-e ADO_PERSONAL_ACCESS_TOKEN="your_pat_here" \
-e ADO_ORGANIZATION_URL="https://dev.azure.com/your_org" \
-e ADO_PROJECT_NAME="your_project" \
ado-mcp-server

Configuration

The server requires the following environment variables:

- ADO_PERSONAL_ACCESS_TOKEN: Your Azure DevOps Personal Access Token
- ADO_ORGANIZATION_URL: Your Azure DevOps organization URL
- ADO_PROJECT_NAME: Your Azure DevOps project name

VS Code Integration

Add this configuration to your VS Code settings to integrate with the MCP server:

{
    "inputs": [
      {
        "type": "promptString",
        "id": "ado_pat",
        "description": "Azure DevOps Personal Access Token",
        "password": true
      },
      {
        "type": "promptString",
        "id": "ado_org",
        "description": "Azure DevOps Organization URL"
      },
      {
        "type": "promptString",
        "id": "ado_project",
        "description": "Azure DevOps Project Name"
      }
    ],
    "servers": {
      "azuredevops": {
        "command": "docker",
        "args": [
          "run",
          "-i",
          "--rm",
          "-e",
          "ADO_PERSONAL_ACCESS_TOKEN",
          "-e",
          "ADO_ORGANIZATION_URL",
          "-e",
          "ADO_PROJECT_NAME",
          "ado-mcp-server"
        ],
        "env": {
          "ADO_PERSONAL_ACCESS_TOKEN": "${input:ado_pat}",
          "ADO_ORGANIZATION_URL": "${input:ado_org}",
          "ADO_PROJECT_NAME": "${input:ado_project}"
        }
      }
    }
}

Features

- Search work items
- Create new work items
- Update existing work items
- Get work item states
- Simple command-line interface for testing

Development

To build and run locally for development:

1. Clone the repository
2. Build the Docker image: docker build -t ado-mcp-server .
3. Run the server with your environment variables

Testing

Run the tests using:

docker run -i --rm \
-e ADO_PERSONAL_ACCESS_TOKEN="your_pat_here" \
-e ADO_ORGANIZATION_URL="https://dev.azure.com/your_org" \
-e ADO_PROJECT_NAME="your_project" \
ado-mcp-server python -m pytest

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.