MCP Server Azdo

🚀 Azure DevOps Server Implementation Guide

This guide details how to implement various Azure DevOps features through the Model Context Protocol (MCP).

✨ Features

This guide elaborates on how to implement various Azure DevOps features via the Model Context Protocol (MCP). The following are the main supported features:

1. Project Management

   • Create a new project.
   • Get a list of all projects.
   • Get detailed information about a specific project.
   • Delete a specified project.

2. Code Repository Management

   • Create a new code repository (including Git and TFVC).
   • Get all code repositories in a project.
   • Get detailed information about a specific code repository.
   • Delete a specified code repository.
   • Manage branches (create, get, delete).

3. Work Item Management

   • Create a new type of work item.
   • Get all work items in a project.
   • Get detailed information about a specific work item.
   • Update the status and attributes of a work item.

4. Test Management

   • Create new test plans and suites.
   • Execute tests and record results.

5. Continuous Integration/Continuous Delivery (CI/CD) Management

   • Create and configure build definitions.
   • Trigger a build run.
   • Get detailed information about a build run.

6. Team Management

   • Add or remove project members.
   • Update user roles and permissions.

7. Area and Iteration Management

   • Create, update, and delete areas.
   • Create, update, and delete iterations.

8. Package Management

   • Upload and download code libraries.
   • Manage files generated by builds.

9. Logging and Reporting

   • View project activity logs.
   • Generate various project statistical reports.

10. Security Settings

    • Update project encryption settings.
    • Manage API access keys.

🚀 Quick Start

Personal Access Token

Follow these steps to create an Azure DevOps Personal Access Token:

Create an Azure DevOps Personal Access Token and ensure the permissions are set correctly:

• Access Personal Access Tokens (in Azure DevOps Settings > Personal Access Tokens).
• Select the required scopes (e.g., Code, Work Items, Test Management).
• Copy the generated token.

Usage on Claude Desktop

To use it on Claude Desktop, add the following content to your claude_desktop_config.json file:

Docker

{
  "mcpServers": {
    "azure-devops": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "DEVOPS_PERSONAL_ACCESS_TOKEN",
        "mcp/azure-devops"
      ],
      "env": {
        "DEVOPS_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

NPX

{
  "mcpServers": {
    "azure-devops": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-azure-devops"
      ],
      "env": {
        "DEVOPS_PERSONAL_ACCESS_TOKEN": "<YOUR_TOKEN>"
      }
    }
  }
}

📄 License

This MCP server is distributed under the MIT License. This means you can freely use, modify, and distribute the software, but you must comply with the terms and conditions of the MIT License. For more details, please refer to the LICENSE file in the project repository.