Skillget

mcp-for-azure-devops-boards

mcp
Guvenlik Denetimi
Uyari
Health Uyari
  • License — License: MIT
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 6 GitHub stars
Code Gecti
  • Code scan — Scanned 6 files during light audit, no dangerous patterns found
Permissions Gecti
  • Permissions — No dangerous permissions requested
Purpose
This server implements the Model Context Protocol (MCP) to allow AI assistants and LLMs to interact with Azure DevOps Boards. It enables users to create, update, and query work items, manage boards, and execute custom WIQL queries directly through their AI client.

Security Assessment
The tool inherently accesses sensitive data because it bridges your AI assistant with your Azure DevOps environment, granting it the ability to read and modify project management data. It does not require hardcoded secrets, instead securely relying on your local, standard Azure CLI (`az login`) authentication. The light code audit found no dangerous patterns, hardcoded credentials, or requests for overly broad permissions. The documentation highlights that running the tool in its default stdio mode is the safest approach, as it prevents exposing credentials over the network. Overall risk is rated as Low for local stdio usage, assuming standard security practices are followed regarding which AI client you connect it to.

Quality Assessment
The project is written in Rust, which provides excellent performance and memory safety. It is highly active, with the last code push occurring just today. The repository includes a valid MIT license and continuous integration workflows for testing and releases. The primary drawback is its low community visibility, currently sitting at only 6 GitHub stars. This means it is a relatively new or niche project with limited community peer review, relying primarily on the single maintainer's diligence.

Verdict
Safe to use, though you should exercise standard caution when granting an AI assistant read and write access to your Azure DevOps organization.
SUMMARY

A Model Context Protocol (MCP) server for interacting with Azure DevOps Boards and Work Items, written in Rust.

README.md

MCP for Azure DevOps Boards

CI - PR - Build & Test
CD - Tag - Build & Release

A Model Context Protocol (MCP) server for interacting with Azure DevOps Boards and Work Items, written in Rust.

Features

  • Work Item Management: Create, update, get, and query work items.

  • Board Integration: List teams, boards, and fetch board items.

  • WIQL Support: Run custom WIQL queries.

  • Simplified Output: Optimized JSON output for LLM consumption (reduced token usage).

Installation

Check out the section MCP Configuration for how to configure your preferred AI (MCP) client.

macOS (Homebrew)

brew tap danielealbano/mcp-tools
brew install mcp-for-azure-devops-boards

The path to the binary will be /opt/homebrew/bin/mcp-for-azure-devops-boards.

Windows (Scoop)

scoop bucket add mcp-tools https://github.com/danielealbano/scoop-mcp-tools
scoop install mcp-for-azure-devops-boards

The path to the binary will be %USERPROFILE%\scoop\apps\mcp-for-azure-devops-boards\current\mcp-for-azure-devops-boards.exe.

Configuration

Setting Description CLI Flag Env Variable
Server Mode Run as HTTP server instead of stdio --server N/A
Port Port for HTTP server (default: 3000) --port N/A

Note: If --server is not specified, the software will run in stdio mode.

Authentication

This server leverages standard Azure authentication mechanisms (like az or azd) to query Azure DevOps.

Installing Azure CLI

If you don't have the Azure CLI installed:

macOS (Homebrew):

brew install azure-cli

Windows (Scoop):

scoop install azure-cli

Windows (Chocolatey):

choco install azure-cli

For other installation methods, see the official Azure CLI installation guide.

Logging In

To authenticate, run:

az login

Usage

Stdio Mode (Default)

This is the standard mode for MCP clients (like Claude Desktop or Cursor). This mode is preferred for security as it ensures no credentials are shared over the network.

path/to/mcp-for-azure-devops-boards

HTTP Server Mode

You can also run it as an HTTP server (SSE). Note that in this mode, the server listens on 0.0.0.0 (all interfaces).

path/to/mcp-for-azure-devops-boards --server --port 3000

MCP Configuration

Note: Make sure you have run az login in your terminal so the process can pick up the credentials.

Quick setup with --install

The fastest way to register the MCP server with your preferred client:

mcp-for-azure-devops-boards --install <target>

Valid targets: claude-code, claude-desktop, cursor, vscode, codex, gemini-cli.

The command auto-detects the binary path, resolves the correct config file location, and writes the entry in the expected format. Existing configuration is preserved.

Manual configuration

Claude Code

Config file: ~/.claude.json

{
  "mcpServers": {
    "mcp-for-azure-devops-boards": {
      "command": "/opt/homebrew/bin/mcp-for-azure-devops-boards"
    }
  }
}

Windows (Scoop): Replace the command path with %USERPROFILE%\\scoop\\apps\\mcp-for-azure-devops-boards\\current\\mcp-for-azure-devops-boards.exe.

Claude Desktop

Config file locations:

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Linux: ~/.config/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcp-for-azure-devops-boards": {
      "command": "/opt/homebrew/bin/mcp-for-azure-devops-boards"
    }
  }
}

Windows (Scoop): Replace the command path with %USERPROFILE%\\scoop\\apps\\mcp-for-azure-devops-boards\\current\\mcp-for-azure-devops-boards.exe.

Cursor

Config file: ~/.cursor/mcp.json

{
  "mcpServers": {
    "mcp-for-azure-devops-boards": {
      "command": "/opt/homebrew/bin/mcp-for-azure-devops-boards"
    }
  }
}

Windows (Scoop): Replace the command path with %USERPROFILE%\\scoop\\apps\\mcp-for-azure-devops-boards\\current\\mcp-for-azure-devops-boards.exe.

VS Code

Config file: .vscode/mcp.json (workspace level)

{
  "servers": {
    "mcp-for-azure-devops-boards": {
      "type": "stdio",
      "command": "/opt/homebrew/bin/mcp-for-azure-devops-boards"
    }
  }
}

Windows (Scoop): Replace the command path with %USERPROFILE%\\scoop\\apps\\mcp-for-azure-devops-boards\\current\\mcp-for-azure-devops-boards.exe.

gemini-cli

Config file: ~/.gemini/settings.json

{
  "mcpServers": {
    "mcp-for-azure-devops-boards": {
      "command": "/opt/homebrew/bin/mcp-for-azure-devops-boards"
    }
  }
}

Windows (Scoop): Replace the command path with %USERPROFILE%\\scoop\\apps\\mcp-for-azure-devops-boards\\current\\mcp-for-azure-devops-boards.exe.

Codex CLI

Config file: ~/.codex/config.toml

[mcp_servers.mcp-for-azure-devops-boards]
command = "/opt/homebrew/bin/mcp-for-azure-devops-boards"

Windows (Scoop): Replace the command path with %USERPROFILE%\\scoop\\apps\\mcp-for-azure-devops-boards\\current\\mcp-for-azure-devops-boards.exe.

Available Tools

This software is currently in development. The tools and their parameters are subject to change.

The server exposes the following tools for MCP clients.

The general structure of the tool names is azdo_VERB_WHAT (e.g., azdo_list_teams, azdo_get_work_item).

Discovery

  • azdo_list_organizations: List all Azure DevOps organizations the authenticated user has access to.
    • Required: None (uses authenticated user's credentials)
  • azdo_list_projects: List all projects in an Azure DevOps organization.
    • Required: organization

Work Items

Note: All work item tools require organization and project parameters.

  • azdo_create_work_item: Create a new work item.
    • Required: organization, project, work_item_type, title
    • Optional: description, assigned_to, area_path, iteration_path, state, board_column, board_row, priority, severity, story_points, effort, remaining_work, tags, activity, parent_id, start_date, target_date, acceptance_criteria, repro_steps, fields (JSON string for custom fields).
  • azdo_update_work_item: Update an existing work item.
    • Required: organization, project, id
    • Optional: All fields available in creation.
  • azdo_get_work_item: Get details of a specific work item.
    • Required: organization, project, id
    • Optional: include_latest_n_comments (number of recent comments to include, -1 for all)
  • azdo_get_work_items: Get multiple work items by their IDs.
    • Required: organization, project, ids (array of work item IDs)
    • Optional: include_latest_n_comments (number of recent comments to include, -1 for all)
  • azdo_query_work_items: Query work items using structured filters.
    • Required: organization, project
    • Optional Filters: area_path, iteration_path, created_date_from/to, modified_date_from/to.
    • Inclusion Lists: include_board_column, include_board_row, include_work_item_type, include_state, include_assigned_to, include_tags.
    • Exclusion Lists: exclude_board_column, exclude_board_row, exclude_work_item_type, exclude_state, exclude_assigned_to, exclude_tags.
    • Optional: include_latest_n_comments (number of recent comments to include, -1 for all)
  • azdo_query_work_items_by_wiql: Execute a raw WIQL (Work Item Query Language) query.
    • Required: organization, project, query
    • Optional: include_latest_n_comments (number of recent comments to include, -1 for all)
  • azdo_add_comment: Add a comment to a work item.
    • Required: organization, project, work_item_id, text
  • azdo_link_work_items: Create a relationship between two work items.
    • Required: organization, project, source_id, target_id, link_type (Parent, Child, Related, Duplicate, Dependency).

Boards & Teams

Note: All board and team tools require organization and project parameters.

  • azdo_list_teams: List all teams in the project.
    • Required: organization, project
  • azdo_get_team: Get details of a specific team.
    • Required: organization, project, team_id
  • azdo_list_team_boards: List boards for a specific team.
    • Required: organization, project, team_id
  • azdo_get_team_board: Get details of a specific board.
    • Required: organization, project, team_id, board_id
  • azdo_list_work_item_types: List all available work item types in the project.
    • Required: organization, project
  • azdo_list_tags: List all tags in use in the project.
    • Required: organization, project
  • azdo_get_team_current_iteration: Get the current active iteration/sprint for a team.
    • Required: organization, project, team_id
  • azdo_get_team_iterations: Get all iterations/sprints for a team.
    • Required: organization, project, team_id

Contributing

We welcome contributions!

  1. Fork the repository.
  2. Create a new branch for your feature or bugfix (git checkout -b feature/amazing-feature).
  3. Commit your changes.
  4. Push to your branch.
  5. Open a Pull Request.

Building from Source

Prerequisites

  • Rust (latest stable version)
  • Azure CLI (required for local authentication)

Steps

  1. Clone the repository:

    git clone https://github.com/danielealbano/mcp-for-azure-devops-boards.git
cd mcp-for-azure-devops-boards

  2. Build the project:

    cargo build --release

Tooling

  • Run tests: cargo test
  • Check code style: cargo fmt --check
  • Linting: cargo clippy

Disclaimer

This project is not affiliated with, endorsed by, or sponsored by Microsoft. Azure, Azure DevOps, and related trademarks are the property of their respective owners. This software uses standard Microsoft's services APIs to interact with Azure and Microsoft Graph, among other services.

License

This project is licensed under the MIT License - see the LICENSE.md file for details.

Yorumlar (0)

Sonuc bulunamadi