Azdo MCP

🚀 Azure DevOps MCP Server

An MCP (Model Context Protocol) server that integrates with Azure DevOps, allowing AI assistants to interact with Azure DevOps work items, pull requests, and wiki pages.

🚀 Quick Start

This server provides seamless integration with Azure DevOps, enabling AI assistants to perform various operations on work items, pull requests, and wiki pages.

✨ Features

• Work item management (create, list, get)
• Pull request operations (create, list, get, comment, diff)
• Wiki page management (create, edit)

📦 Installation

Prerequisites

1. Install dependencies:

npm install

2. Configure environment variables (create a .env file):

AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-org
AZURE_DEVOPS_PAT=Your personal access token
AZURE_DEVOPS_PROJECT=default-project
AZURE_DEVOPS_REPOSITORY=default-repo

3. Build the server:

npm run build

Configuration

Add the server configuration to your MCP settings:

For VSCode

On macOS/Linux

Add the following to ~/.vscode/cline_mcp_settings.json or similar:

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["/path/to/azure-devops-mcp/build/index.js"],
      "devMode": false
    }
  }
}

On Windows

Add the following to C:\\Users\\<YourUsername>\\.vscode\\cline_mcp_settings.json:

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["C:\\path\\to\\azure-devops-mcp\\build\\index.js"],
      "devMode": false
    }
  }
}

💻 Usage Examples

Basic Usage

Work Items

Create a work item

POST /workitems
Content-Type: application/json

{
  "title": "New Task",
  "description": "This is a new Azure DevOps work item.",
  "project": "default-project",
  "type": "task"
}

Get all work items

GET /workitems

Get a specific work item

GET /workitems/{id}

Pull Requests

Create a pull request

POST /pullrequests
Content-Type: application/json

{
  "sourceBranch": "refs/heads/main",
  "targetBranch": "refs/heads/master",
  "title": "New Feature Commit"
}

Get all pull requests

GET /pullrequests

Get a specific pull request

GET /pullrequests/{id}

Wiki

Create a wiki page

POST /wiki/defaultwiki/_/newfile
Content-Type: application/json

{
  "path": "/pages/home.md",
  "content": "## Welcome to our new wiki!"
}

Update a wiki page

PUT /wiki/defaultwiki/_/file/pages/home.md
Content-Type: application/json

{
  "content": "## Welcome to the updated wiki!",
  "etag": "12345678-90AB-CDEF-1234-567890ABCDEF"
}

Advanced Usage

Run in development mode with environment variables:

npm run dev

⚠️ Important Note

Unless project and repository are explicitly specified in the tool parameters, the default values specified in your environment configuration will be used.