Azure Boards MCP

io.github.broisnischal由 GitHub 帳號 broisnischal 發布v1.0.0更新於 Oct 24, 2026

Azure DevOps Boards work items over MCP (stdio). Requires Bun, org, project, and PAT.

已驗證STDIO僅桌面效率與工作流開發者工具

概覽

AI 產生的概覽

本機 MCP 伺服器,讓助理讀寫 Azure DevOps 的工作項目、看板、衝刺、儲存庫、提取要求與管線。

可以做什麼
  • 檢查驗證狀態並切換目前的 Azure DevOps 專案
  • 列出、建立、更新、刪除、連結與查詢工作項目、留言、歷程記錄與待辦項目
  • 檢視衝刺、看板、團隊成員以及區域/反覆項目路徑
  • 瀏覽儲存庫、檔案、提交與分支;讀取、留言、投票並合併提取要求
  • 列出、執行與取消管線和組建,查看組建記錄與時間軸,並建立發行
適用情境
當團隊在 Azure DevOps Boards 追蹤工作,並希望助理不必離開編輯器就能分類工單、更新衝刺、審閱提取要求或排查失敗的組建時適用。
執行需求
透過 npx 在本機執行(需要 Node.js;描述中提到 Bun)。需要 Azure DevOps 組織名稱、專案名稱,以及瀏覽器登入或透過 AZURE_ORG、AZURE_PROJECT 與 AZURE_PAT(OAuth 時用 AUTH_TOKEN)提供的個人存取權杖。需要連線至 Azure DevOps 的網路。
安裝前請注意
PAT 是具備工作項目讀寫及組建/程式碼讀取權限的憑證,需妥善保管。許多工具會寫入、合併或刪除:建立與刪除工作項目、張貼留言、合併或放棄提取要求、觸發與取消組建、建立發行。瀏覽器登入使用內建於套件中的共用應用程式註冊,部分組織會封鎖。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Azure Boards MCP,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Desktop only,透過 STDIO。 STDIO 服務會啟動本機處理程序,因此需要 SourceWeft 桌面主機。

其他 MCP 客戶端

參照 儲存庫 中的啟動說明。

README

azure-board-mcp

MCP server for Azure DevOps. Work with tasks, sprints, bugs, pull requests, repositories, and pipelines directly from Claude, Cursor, or any MCP-compatible AI.


Quick start

bash
# 1. Configure your editors (Claude Code, Cursor, VS Code, Claude Desktop)npx azure-board-mcp install
# 2. Sign in oncenpx azure-board-mcp authenticate
# 3. Restart your editor — done

On first use the AI will ask which Azure DevOps project to work on and remember it.


Install & authenticate

Browser sign-in (default)

bash
npx azure-board-mcp authenticate

Opens your browser for Microsoft sign-in. Picks your org from a list. No Azure AD app setup required — uses a shared app registration built into the package.

PAT — Personal Access Token

For headless / CI environments or orgs that block third-party OAuth:

bash
npx azure-board-mcp authenticate --pat

Create a PAT at https://dev.azure.com/{org}/_usersSettings/tokens with scopes: Work Items (Read & Write), Build (Read), Code (Read).


Editor setup

Option A — automatic (recommended)

bash
npx azure-board-mcp install

Detects and configures Claude Code, Cursor, VS Code, and Claude Desktop automatically.

Option B — manual

Claude Code (~/.claude/settings.json):

json
{  "mcpServers": {    "azure": {      "command": "npx",      "args": ["-y", "azure-board-mcp@latest"]    }  }}

Cursor (~/.cursor/mcp.json):

json
{  "mcpServers": {    "azure": {      "command": "npx",      "args": ["-y", "azure-board-mcp@latest"]    }  }}

VS Code (User settings.json):

json
{  "mcp": {    "servers": {      "azure": {        "type": "stdio",        "command": "npx",        "args": ["-y", "azure-board-mcp@latest"]      }    }  }}

Claude Desktop (claude_desktop_config.json):

json
{  "mcpServers": {    "azure": {      "command": "npx",      "args": ["-y", "azure-board-mcp@latest"]    }  }}

Claude Code skill

Install a skill so Claude automatically knows when to use this MCP:

bash
npx azure-board-mcp skills

This installs ~/.claude/skills/azure-board-mcp/SKILL.md. After restarting Claude Code, it will proactively use Azure DevOps tools whenever you ask about tasks, sprints, PRs, builds, etc.


CLI reference

npx azure-board-mcp <command>
COMMANDS  install               Auto-configure MCP in detected editors  skills                Install the Claude Code skill  authenticate          Browser OAuth sign-in  authenticate --pat    Personal Access Token sign-in  check                 Validate stored credentials  logout                Clear stored credentials  help                  Show help
AUTHENTICATE FLAGS  --pat                 Use PAT instead of browser OAuth  --read-only           Request read-only OAuth scopes  --client-id <id>      Use your own Azure AD app  --tenant-id <id>      Specify tenant (single-tenant apps only)

Tools (30)

Work-item, commit, and PR lists are paginated — they return a compact page (default 15, max 50) with a Showing X–Y of N header. Pass skip to page through results instead of requesting a large top. List views fetch only the fields they render, so they're fast and light on context.

Auth & project

ToolWhen to use
auth_statusDiagnose auth issues, check which project is active
switch_projectChange the active project, or list available ones

Work items

ToolWhen to use
list_work_itemsMy tasks, sprint board, filter by state/type/keyword (paginated)
get_work_itemFull detail on a specific ticket: every field (custom ones like Definition of Done too), all comments, PRs. Nothing truncated
create_work_itemCreate a task, bug, user story, epic, feature
update_work_itemClose, reassign, move sprint, update estimates
add_commentPost a note or status update on a ticket
list_comments / update_comment / delete_commentRead, edit, or delete ticket comments by ID
list_child_work_itemsSubtasks of a ticket, optionally the whole subtree
delete_work_itemMove to Recycle Bin, or destroy permanently
link_work_itemsSet parent/child, related, or dependency links
query_wiqlAdvanced queries with custom WIQL (paginated)
get_work_item_historyAudit trail — which fields changed, when, by whom
get_backlogOrdered, priority-ranked product backlog

Boards, sprints & teams

ToolWhen to use
get_sprintCurrent sprint dates and team capacity
list_sprintsAll sprints with start/end dates
get_boardKanban columns, state mappings, WIP limits
list_team_membersWho's on a team (names, emails, admin flag)
list_pathsValid area / iteration path values for create/update

Repositories

ToolWhen to use
list_reposDiscover repo names and URLs
list_filesBrowse directory structure
get_fileRead file contents (up to 500 lines)
list_commitsRecent commits on a branch (paginated)
list_pull_requestsOpen PRs, reviewer votes, merge status (paginated)
list_branchesBranches with ahead/behind counts
create_prOpen a PR with reviewers (by email), linked work items, optional auto-complete
get_pull_requestFull PR: description, reviewers and votes, linked work items, changed files
list_pr_commentsComment threads with file/line context and replies
add_pr_commentGeneral comment, inline file comment, or reply to a thread
update_pr_threadResolve or reopen a thread
vote_prApprove, approve with suggestions, wait for author, reject, reset
manage_pr_reviewersAdd (optionally required) or remove reviewers
update_prEdit title/description/draft, complete (merge), auto-complete, abandon, reactivate

Pipelines, builds & releases

ToolWhen to use
list_pipelinesDiscover pipeline definitions
list_buildsRecent builds — status, result, branch, link
run_pipelineTrigger a pipeline run
get_build_timelineWhich stage/job/task failed, with error/warning counts
get_build_logsFull logs and error messages of failed steps, or any step by name or log ID
cancel_buildCancel an in-progress build
list_releasesRecent releases with per-environment deploy status
create_releaseCreate and trigger a release from a definition

Environment variables

Override stored credentials — useful for CI/Docker:

bash
AZURE_ORG=my-orgAZURE_PROJECT=my-projectAZURE_PAT=my-pat        # PAT authAUTH_TOKEN=my-token     # OAuth bearer token

Using your own Azure AD app

By default everyone shares the built-in app registration. If your org blocks it, or you need full control:

1. Register the app

  1. Azure Portal → App registrations → New registration
  2. Name: anything (e.g. azure-board-mcp)
  3. Supported account types: "Any organizational directory" (multitenant) or "My organization only"
  4. Click Register

2. Configure it

In Authentication:

  1. Add a platform → Mobile and desktop applications → check http://localhost → Configure
  2. Allow public client flows → Yes → Save

In API permissions:

  1. Add a permission → APIs my organization uses → search Azure DevOps
  2. Select user_impersonation (delegated) → Add
  3. Click Grant admin consent (optional — skips the per-user consent prompt)

3. Use it

bash
npx azure-board-mcp authenticate --client-id <your-app-id>
# Single-tenant:npx azure-board-mcp authenticate --client-id <your-app-id> --tenant-id <your-tenant-id>

For org admins — pre-approve for everyone in your org:

https://login.microsoftonline.com/{tenant-id}/adminconsent  ?client_id=e2ba32e7-6d24-4919-ba7b-37199c495247  &redirect_uri=http://localhost

License

MIT

來源:README.md,提交 4f5773d

工具

0
SourceWeft 尚未在沙箱中啟動過該軟體包,因此其工具未知。

版本歷史

1
  1. v1.0.0最新Sep 16, 2026

評分

已滿足適用檢查項的 40%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通25 分

    請保持端點能夠回應 MCP 握手;SourceWeft 每 30 天探測一次。

  • 已宣告認證方式10 分

    請在註冊中心條目中宣告憑證請求標頭,或保持端點能夠回應探測,以便判定其認證方式。

  • 已列出工具15 分

    請讓伺服器在無憑證時回應 tools/list,或發布可在沙箱中無憑證啟動的軟體包。

  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分

    請在儲存庫或註冊中心條目中宣告授權條款。