Azure DevOps Server MCP

A Model Context Protocol (MCP) server for Azure DevOps Server (TFS). If you are looking for the Azure DevOps Services Cloud version, please see the official azure-devops-mcp from Microsoft.

Features

• Git Repositories: List repositories, browse files, get commit history, and manage branches
• Pull Requests: Create, read, update PRs, manage comments and reviews
• Team Projects: List projects, get project details, and manage teams
• Work Items: Create, read, update, and query work items with full field support
• WIQL Support: Execute custom Work Item Query Language queries

Prerequisites

Python 3.10+

Ensure you have Python 3.10+ installed:

python --version
python3 --version

Using uvx (Recommended)

Install uv for fast Python package management:

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Configuration

Personal Access Token

To interact with Azure DevOps Server, you need a Personal Access Token (PAT). Make sure to only use this PAT with the MCP server and no other applications.

1. Go to your Azure DevOps Server web interface
2. Click on user top right corner -> Security → Personal Access Tokens
3. Create a new token with the following scopes:
   • Work Items: Read & Write
   • Project and Team: Read
   • Code: Read & Write (for Git repositories and Pull Requests)

MCP Configuration

If you want to avoid putting sensitive information like the token in the config file, you can set them as environment:

Linux / macOS:

You can add the following variables to your shell profile (e.g., ~/.bashrc, ~/.zshrc) to not have them in the config file:

export AZURE_DEVOPS_SERVER_URL="https://your-server.company.com/tfs"
export AZURE_DEVOPS_SERVER_TOKEN="your-personal-access-token"
export AZURE_DEVOPS_SERVER_API_VERSION="7.1-preview.3"
export AZURE_DEVOPS_SERVER_COLLECTION="collection-name"

Windows:

You can add the following variables to your system environment or user environment to not have them in the config file:

setx AZURE_DEVOPS_SERVER_URL "https://your-server.company.com/tfs"
setx AZURE_DEVOPS_SERVER_TOKEN "your-personal-access-token"
setx AZURE_DEVOPS_SERVER_API_VERSION "7.1-preview.3"
setx AZURE_DEVOPS_SERVER_COLLECTION "collection-name"

After setting environment variables, you can use them in the MCP config like this:

{
  "mcpServers": {
    "azure-devops-server": {
      "command": "uvx",
      "args": [
        "git+https://github.com/Ravio1i/azure-devops-server-mcp.git"
      ],
    }
  }
}

see https://code.visualstudio.com/docs/copilot/customization/mcp-servers For GitHub Copilot it uses servers instead of mcpServers:

{
  "servers": {
    "azure-devops-server": {