📌Overview

Purpose: To integrate Azure DevOps services seamlessly with the Cline application, enhancing its capabilities for project management and development workflows.

Overview: The Azure DevOps MCP Server for Cline acts as a bridge between Cline and various Azure DevOps functionalities, enabling users to manage work items, pipelines, pull requests, and more directly from the Cline interface. This server leverages personal access tokens for secure communication with Azure DevOps APIs.

Key Features:

Work Item Management: Allows users to create, retrieve, update, and list work items, facilitating effective tracking of tasks, bugs, and user stories.
Pipeline Operations: Provides functionalities to list and trigger pipelines, streamlining the CI/CD processes within Azure DevOps.
Pull Request Handling: Enables users to create, update, and list pull requests, promoting collaborative code review and integration.
Wiki Management: Facilitates the creation and updating of wikis, enhancing documentation practices within projects.
Project Insights: Offers tools to list projects within the Azure DevOps organization for better organization and visibility.

Azure DevOps MCP Server for Cline

This Model Context Protocol (MCP) server provides integration with Azure DevOps, allowing Cline to interact with Azure DevOps services.

Prerequisites

Node.js (v20 LTS or higher)
npm (comes with Node.js)
A Cline installation
Azure DevOps account with access tokens

Installation

Installing via Smithery

To install Azure DevOps Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @stefanskiasan/azure-devops-mcp-server --client claude

Manual Installation

Clone this repository:

git clone https://github.com/stefanskiasan/azure-devops-mcp-server.git
cd azure-devops-mcp-server

Install dependencies:

npm install

Build the server:

npm run build

Note: The build output (build/ directory) is not included in version control. You must run the build command after cloning the repository.

Configuration

1. Get Azure DevOps Personal Access Token (PAT)

Sign in to Azure DevOps.
Click on your profile picture in the top right.
Select "Security".
Click "New Token".
Give your token a name and select the required scopes:
- Code (read, write) - For Pull Request operations
- Work Items (read, write) - For Work Item management
- Build (read, execute) - For Pipeline operations
- Wiki (read, write) - For Wiki operations
- Project and Team (read) - For Project and Board information
Copy the generated token.

2. Configure Cline MCP Settings

Add the server configuration to your Cline MCP settings file:

For VSCode extension: %APPDATA%/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json
For Claude desktop app: %LOCALAPPDATA%/Claude/claude_desktop_config.json

Add the following configuration to the mcpServers object:

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["/absolute/path/to/azure-devops-server/build/index.js"],
      "env": {
        "AZURE_DEVOPS_ORG": "your-organization",
        "AZURE_DEVOPS_PAT": "your-personal-access-token",
        "AZURE_DEVOPS_PROJECT": "your-project-name"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

Replace the following values:

/absolute/path/to/azure-devops-server: The absolute path to where you cloned this repository
your-organization: Your Azure DevOps organization name
your-project-name: Your Azure DevOps project name
your-personal-access-token: The PAT you generated in step 1

Available Tools

Work Items

get_work_item: Get a work item by ID
list_work_items: Query work items using WIQL
create_work_item: Create a new work item (Bug, Task, User Story)
update_work_item: Update an existing work item

Boards

get_boards: Get available boards in the project

Pipelines

list_pipelines: List all pipelines in the project
trigger_pipeline: Execute a pipeline

Pull Requests

list_pull_requests: List pull requests
create_pull_request: Create a new pull request
update_pull_request: Update a pull request
get_pull_request: Get pull request details

Wiki

get_wikis: List all wikis in the project
get_wiki_page: Get a wiki page
create_wiki: Create a new wiki
update_wiki_page: Create or update a wiki page

Projects

list_projects: List all projects in the Azure DevOps organization

Verification

Restart Cline (or VSCode) after adding the configuration.
The Azure DevOps MCP server should now be listed in Cline's capabilities.
You can verify the installation using the MCP Inspector:

npm run inspector

Troubleshooting

Check that the path in your MCP settings is correct.
Verify your Azure DevOps credentials.
Check the Cline logs for any error messages.
Verify your PAT hasn't expired and has all necessary scopes.
Double-check the organization and project names.
Run the inspector tool to verify the server is working correctly.
Check the server logs for any error messages.

Development

To modify or extend the server:

Make your changes in the src directory.
Run npm run watch for development.
Build with npm run build when ready.
Test using the inspector: npm run inspector

License

MIT License - See LICENSE for details