mcp-server-azdo

mcp-server-azdo

0
developer_toolscloud_platforms

The Azure DevOps MCP Server facilitates file operations, repository management, and search functionalities through Azure DevOps Services API. It includes features such as automatic branch creation, comprehensive error handling, and advanced search capabilities. The server is currently under active development and testing.

Azure DevOps MCP Server

MCP Server for the Azure DevOps Services API, enabling file operations, repository management, search functionality, and more.

[!WARNING]
This implementation is not yet tested and undergoing active development.

Features

  • Automatic Branch Creation: When creating/updating files or pushing changes, branches are automatically created if they don't exist
  • Comprehensive Error Handling: Clear error messages for common issues
  • Git History Preservation: Operations maintain proper Git history without force pushing
  • Batch Operations: Support for both single-file and multi-file operations
  • Advanced Search: Support for searching code, work items, pull requests, and users

Tools

  1. create_or_update_file

    • Create or update a single file in a repository
    • Inputs:
      • project (string): Azure DevOps project name
      • repo (string): Repository name
      • path (string): Path where to create/update the file
      • content (string): Content of the file
      • message (string): Commit message
      • branch (string): Branch to create/update the file in
      • sha (optional string): SHA of file being replaced (for updates)
    • Returns: File content and commit details

  2. push_files

    • Push multiple files in a single commit
    • Inputs:
      • project (string): Azure DevOps project name
      • repo (string): Repository name
      • branch (string): Branch to push to
      • files (array): Files to push, each with path and content
      • message (string): Commit message
    • Returns: Updated branch reference

  3. search_repositories

    • Search for Azure DevOps repositories
    • Inputs:
      • query (string): Search query
      • page (optional number): Page number for pagination
      • perPage (optional number): Results per page (max 100)
    • Returns: Repository search results

  4. create_repository

    • Create a new Azure DevOps repository
    • Inputs:
      • project (string): Azure DevOps project name
      • name (string): Repository name
      • description (optional string): Repository description
      • defaultBranch (optional string): Default branch name
    • Returns: Created repository details

  5. get_file_contents

    • Get contents of a file or directory
    • Inputs:
      • project (string): Azure DevOps project name
      • repo (string): Repository name
      • path (string): Path to file/directory
      • branch (optional string): Branch to get contents from
    • Returns: File/directory contents

  6. create_work_item

    • Create a new work item (issue, task, etc.)
    • Inputs:
      • project (string): Azure DevOps project name
      • type (string): Work item type (e.g., Bug, Task)
      • fields (object): Fields for the work item (e.g., System.Title, System.Description)
    • Returns: Created work item details

  7. create_pull_request

    • Create a new pull request
    • Inputs:
      • project (string): Azure DevOps project name
      • repo (string): Repository name
      • title (string): PR title
      • description (optional string): PR description
      • sourceBranch (string): Branch containing changes
      • targetBranch (string): Branch to merge into
      • reviewers (optional array): List of reviewers
    • Returns: Created pull request details

  8. list_dashboards

    • List dashboards in a project
    • Inputs:
      • project (string): Azure DevOps project name
    • Returns: Array of dashboard details

  9. list_queries

    • List queries in a project
    • Inputs:
      • project (string): Azure DevOps project name
    • Returns: Array of query details

  10. list_test_cases

    • List test cases in a project
    • Inputs:
      • project (string): Azure DevOps project name
      • planId (optional number): Test plan ID to filter test cases
    • Returns: Array of test case details

  11. list_test_plans

    • List test plans in a project
    • Inputs:
      • project (string): Azure DevOps project name
    • Returns: Array of test plan details

  12. list_artifacts

    • List artifacts in a project
    • Inputs:
      • project (string): Azure DevOps project name
    • Returns: Array of artifact details

  13. list_artifact_feeds

    • List artifact feeds in an organization
    • Inputs:
      • organization (string): Azure DevOps organization name
    • Returns: Array of artifact feed details

  14. get_artifact_feed

    • Get a specific artifact feed
    • Inputs:
      • organization (string): Azure DevOps organization name
      • feedId (string): Feed ID
    • Returns: Artifact feed details

  15. create_artifact_feed

    • Create a new artifact feed
    • Inputs:
      • organization (string): Azure DevOps organization name
      • name (string): Feed name
      • description (optional string): Feed description
      • project (optional string): Project ID
    • Returns: Created feed details

  16. update_artifact_feed

    • Update an artifact feed
    • Inputs:
      • organization (string): Azure DevOps organization name
      • feedId (string): Feed ID
      • name (optional string): New name
      • description (optional string): New description
    • Returns: Updated feed details

  17. delete_artifact_feed

    • Delete an artifact feed
    • Inputs:
      • organization (string): Azure DevOps organization name
      • feedId (string): Feed ID
    • Returns: Success status

  18. list_artifact_packages

    • List packages in a feed
    • Inputs:
      • organization (string): Azure DevOps organization name
      • feedId (string): Feed ID
    • Returns: Array of package details

  19. get_artifact_package

    • Get a specific package in a feed
    • Inputs:
      • organization (string): Azure DevOps organization name
      • feedId (string): Feed ID
      • packageId (string): Package ID
    • Returns: Package details

  20. delete_artifact_package

    • Delete a package from a feed
    • Inputs:
      • organization (string): Azure DevOps organization name
      • feedId (string): Feed ID
      • packageId (string): Package ID
    • Returns: Success status

  21. list_artifact_views

    • List views in a feed
    • Inputs:
      • organization (string): Azure DevOps organization name
      • feedId (string): Feed ID
    • Returns: Array of view details

  22. get_artifact_view

    • Get a specific view in a feed
    • Inputs:
      • organization (string): Azure DevOps organization name
      • feedId (string): Feed ID
      • viewId (string): View ID
    • Returns: View details

  23. create_artifact_view

    • Create a new view in a feed
    • Inputs:
      • organization (string): Azure DevOps organization name
      • feedId (string): Feed ID
      • name (string): View name
      • description (optional string): View description
    • Returns: Created view details

  24. update_artifact_view

    • Update a view in a feed
    • Inputs:
      • organization (string): Azure DevOps organization name
      • feedId (string): Feed ID
      • viewId (string): View ID
      • name (optional string): New name
      • description (optional string): New description
    • Returns: Updated view details

  25. delete_artifact_view

    • Delete a view from a feed
    • Inputs:
      • organization (string): Azure DevOps organization name
      • feedId (string): Feed ID
      • viewId (string): View ID
    • Returns: Success status

  26. list_projects

    • List all projects in the organization
    • Inputs: none
    • Returns: Array of project details

  27. get_project

    • Get details of a specific project
    • Inputs:
      • id (string): Project ID or name
    • Returns: Project details

  28. create_project

    • Create a new project
    • Inputs:
      • name (string): Project name
      • description (optional string): Project description
      • visibility (string): private or public
      • processTemplateId (string): ID of the process template
    • Returns: Created project details

  29. update_project

    • Update an existing project
    • Inputs:
      • id (string): Project ID
      • name (optional string): New name
      • description (optional string): New description
      • visibility (optional string): private or public
    • Returns: Updated project details

  30. delete_project

    • Delete a project
    • Inputs:
      • id (string): Project ID
    • Returns: Success status

  31. list_process_templates

    • List all process templates
    • Inputs: none
    • Returns: Array of process template details

  32. get_process_template

    • Get details of a process template
    • Inputs:
      • id (string): Process template ID
    • Returns: Process template details

  33. list_iterations

    • List all iterations in a project
    • Inputs:
      • project (string): Project name or ID
    • Returns: Array of iteration details

  34. get_iteration

    • Get details of a specific iteration
    • Inputs:
      • project (string): Project name or ID
      • id (string): Iteration ID
    • Returns: Iteration details

  35. create_iteration

    • Create a new iteration in a project
    • Inputs:
      • project (string): Project name or ID
      • name (string): Iteration name
      • startDate (optional string): Start date
      • finishDate (optional string): Finish date
      • path (optional string): Path for the iteration
    • Returns: Created iteration details

  36. update_iteration

    • Update an iteration
    • Inputs:
      • project (string): Project name or ID
      • id (string): Iteration ID
      • name (optional string): New name
      • startDate (optional string): New start date
      • finishDate (optional string): New finish date
    • Returns: Updated iteration details

  37. delete_iteration

    • Delete an iteration
    • Inputs:
      • project (string): Project name or ID
      • id (string): Iteration ID
    • Returns: Success status

  38. list_areas

    • List all areas in a project
    • Inputs:
      • project (string): Project name or ID
    • Returns: Array of area details

  39. get_area

    • Get details of a specific area
    • Inputs:
      • project (string): Project name or ID
      • id (string): Area ID
    • Returns: Area details

  40. create_area

    • Create a new area in a project
    • Inputs:
      • project (string): Project name or ID
      • name (string): Area name
      • path (optional string): Path for the area
    • Returns: Created area details

  41. update_area

    • Update an area
    • Inputs:
      • project (string): Project name or ID
      • id (string): Area ID
      • name (optional string): New name
      • path (optional string): New path
    • Returns: Updated area details

  42. delete_area

    • Delete an area
    • Inputs:
      • project (string): Project name or ID
      • id (string): Area ID
    • Returns: Success status

Setup

Personal Access Token

Create an Azure DevOps Personal Access Token with appropriate permissions:

  • Go to 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 with Claude Desktop

To use this with Claude Desktop, add the following to your claude_desktop_config.json:

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 licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.