mcp-azure-devops

![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg

Model Context Protocol のための Azure DevOps サーバーです。MCP 対応クライアント（Claude Desktop、Claude Code、Cursor、Codex、…）が ボード（boards）、リポジトリ、パイプライン、プロジェクト を横断して扱えるようにし、AI エージェントを安全な境界内に留めるガバナンス層を備えています。

提供される機能

• Projects & teams — プロジェクト・チーム・メンバーの一覧表示、プロセス テンプレートの確認。

• Boards / work items — WIQL クエリ、作業項目の取得、作業項目の作成・更新、イテレーション（スプリント）の一覧。

• Repos / pull requests — リポジトリとブランチの一覧、PR の一覧・取得、PR の作成。

• Pipelines / builds — パイプラインと直近のビルドの一覧、ビルドの取得、ランの実施依頼。

• Admin / process — プロセス レートの一覧、プロジェクトの作成、プロジャクトの削除（ガード付き）。

• 駆括内のガバナンス (Governance built) — アクセスモード、プロジェクトの allowlist、プロジェクトの保護、削除の強力、高検知操作の型付き確認、ドライラ、JSON 監査ログ。

Related MCP server: Azure DevOps MCP Server

ガバナンスとセキュリティ モデル

ツール

読み取り（read-only+）: list_projects, get_project, list_teams, list_team_members, list_process, query_work_items, get_work_item, list_turations, list_repositories, list_brans, list_pull_requests, get_pull_request, list_pipelines, list_builds, get_build

書き込み（read-write+）: create_work_item, update_work_item, create_pull_request, run_pipeline

管理(admin): create_project, delete_project（AZDO_ALLOW_DELETE と同型の confirm が必要）

クイックスタート — エージェントへ追加

npm に @dockndevai/mcp-azure-devops として公開されています。npx で実行でき、組織 (org) と PAT が必要です。各クライアントについては docs/CLIENTS.md を、すべての環境変数は .env.example を参照してください。

Claude Code

claude mcp add azure-devops -e AZDO_ORG_URL="https://dev.azure.com/your-org" -e AZDO_PAT="your-pat" -e AZDO_MODE="read-only" -- npx -y @dockndevai/mcp-azure-devops

Claude Desktop · Cursor · Windsurf

{
  "mcpServers": {
    "azure-devops": {
      "command": "npx",
      "args": ["-y", "@dockndevai/mcp-azure-devops"],
      "env": {
        "AZDO_ORG_URL": "https://dev.azure.com/your-org",
        "AZDO_PAT": "your-pat",
        "AZDO_MODE": "read-only"
      }
    }
  }
}

使用例

• "Payments プロジェクトの api リポジトリの未完了の pull requests を一覧する"

• "自分に割り当てられた Active の作業項目をクエリする"

• "Web プロジェクトの直近 10 件のビルドを表示し、どのビルドが失敗したかを確認する"

• "Payments に 'Checkout 500 on retry' というタイトルの Bug を作成する"（read-write が必要）

ソースから実行（開発時）

npm install
npm run build
node dist/index.js   # with the environment variables set

開発

npm run dev
npm test          # governance policy: modes, allowlists, delete gating, confirmation
npm run typecheck

公開

公式の MCP レジストリ用の server.json と、npm の所有権検証用の mcpName を同梱しています。詳細は PUBLISHING.md を参照してください。

ライセンス

MIT