mcp-azure-devops

mcp-azure-devops

Azure DevOps 用の Model Context Protocol サーバーです。MCP 対応クライアント（Claude Desktop、Claude Code、Cursor、Codex、…）から、ボード、リポジトリ、パイプライン、プロジェクトを横断して操作できます。また、AI エージェントが安全な範囲内で動作するよう、ガバナンスレイヤーを備えています。

提供機能

• プロジェクトとチーム — プロジェクト、チーム、メンバーの一覧表示、プロセステンプレートの確認。
• ボード／作業項目 — WIQL クエリ、作業項目の取得、作業項目の作成／更新、イテレーション（スプリント）の一覧表示。
• リポジトリ／プルリクエスト — リポジトリとブランチの一覧表示、PR の一覧表示／取得、PR の作成。
• パイプライン／ビルド — パイプラインと最近のビルドの一覧表示、ビルドの取得、実行のキュー登録。
• 管理／プロセス — プロセステンプレートの一覧表示、プロジェクトの作成、プロジェクトの削除（制限付き）。
• ガバナンスを標準搭載 — アクセスモード、プロジェクト許可リスト、保護されたプロジェクト、削除制限、高影響操作に対する型付き確認、ドライラン、JSON 監査ログ。

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

懸念事項	フラグ	デフォルト	効果
サーバーが実行できる操作は？	AZDO_MODE	read-only	read-only → 読み取り；read-write → 作業項目、PR、パイプライン実行；admin → プロジェクトの作成／削除。設定モードを超えるツールは登録されません。
対象となるプロジェクトは？	AZDO_PROJECT_ALLOWLIST	(すべて)	対象外のプロジェクトに対する操作は拒否されます。
常に読み取り専用にするプロジェクトは？	AZDO_PROTECTED_PROJECTS	(なし)	読み取り可能ですが、変更はできません。
削除を許可するか？	AZDO_ALLOW_DELETE	false	delete_project には、この設定と admin モードの両方が必要です。
型付き確認	AZDO_REQUIRE_CONFIRMATION	true	高影響操作では、confirm に単なる真偽値ではなく、対象名と一致する値を指定する必要があります。
プレビュー	AZDO_DRY_RUN	false	書き込み／管理ツールは検証して意図をログに記録した後、結果を返します。
監査証跡	AZDO_AUDIT_LOG	true	制限対象の操作ごとに、JSON 形式の1行を stderr に出力します。
対話型確認	(自動)	—	破壊的な操作や高影響操作の実行前に、MCP elicitation を使って人間に承認を求めます。elicitation に対応していないクライアントでは、*_ALLOW_* による制限にフォールバックします。

ツール

読み取り（read-only 以上）：list_projects、get_project、list_teams、list_team_members、list_processes、query_work_items、get_work_item、list_iterations、list_repositories、list_branches、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 で実行でき、組織と 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 リポジトリにある、アクティブなプルリクエストを一覧表示して」
• 「自分に割り当てられていて、まだ 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