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 分

    请在仓库或注册中心条目中声明许可证。