Efficient Ado

@om surushe/高效ado

LLM为AI助手优化了Azure DevOps工作流

高效ADO 是一个模型上下文协议（MCP）服务器，为AI助手提供对Azure DevOps的简化访问。它基于代理优先的设计原则构建，最大限度地减少了往返次数，减少了令牌的使用，并提供了丰富的上下文响应。

特性

• 🎯 代理优先设计 -复合工具减少了往返次数
• ⚡ 代币高效 -分层响应（摘要/标准/详细）
• 🤖 LLM优化 -丰富的上下文+每个响应中的建议行动
• 🚀 快 -使用TypeScript构建，针对性能进行了优化
• 📦 完成 -34种工具，涵盖PR、工作项、repo、分支
• 🔄 复合工作流 -单次通话中的多步操作
• 🧠 错误指导 -错误告诉代理如何解决问题

安装

npm install @om-surushe/efficient-ado

快速开始

配置

创建一个 .env 文件：

AZDO_ORG_URL=https://dev.azure.com/your-org
AZDO_PAT=your-personal-access-token
AZDO_PROJECT=your-project  # optional
AZDO_REPO=your-repo        # optional

PAT要求：

• 代码（读写）
• 拉取请求线程（读写）
• 工作项（读写）

使用Claude Desktop

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "efficient-ado": {
      "command": "npx",
      "args": ["@om-surushe/efficient-ado"],
      "env": {
        "AZDO_ORG_URL": "https://dev.azure.com/your-org",
        "AZDO_PAT": "your-pat-here",
        "AZDO_PROJECT": "your-project",
        "AZDO_REPO": "your-repo"
      }
    }
  }
}

与OpenClaw/Cline/其他MCP客户端一起使用

类似的配置-使用带有环境变量的stdio传输。

可用工具（共34个）

基础

• setup_workspace -配置凭据并验证连接

Pull请求工作流

发现：

• list_prs -列出带有过滤器的PR（创建者、审阅者、状态）
• get_pr -获取审阅者和状态的PR详细信息
• start_review - 复合 -在一次通话中获得PR+评论+评论者

审查和批准：

• vote_on_pr -批准（10）、带建议批准（5）、等待（-5）、拒绝（-10）
• manage_reviewers -添加/删除审阅者
• quick_approve - 复合 -批准+合并（如果准备好）

合并：

• check_merge_readiness -验证所有合并要求
• complete_pr -将PR与完成选项合并

评论和主题：

• list_comments -列出所有线程（常规+内联）
• add_comment -添加常规或内联注释
• reply_to_thread -回复现有帖子
• update_thread_status -将螺纹标记为固定/活动/未固定/已关闭
• address_comment - 复合 -一通电话回复+解决

文件差异（&D）：

• get_pr_changes -列出已更改的文件及其统计信息
• get_file_diff -获取文件差异（并排比较）
• get_file_content -在PR提交时获取文件内容

公关生命周期：

• create_pr -使用工作项、审阅者、自动完成创建PR
• update_pr -更新标题、描述、草稿状态
• abandon_pr -关闭PR而不合并
• reactivate_pr -重新打开废弃的PR

工作项

• get_work_item -通过具有关系的ID获取工作项
• list_my_work_items -列出分配给您的工作项
• create_work_item -创建新任务/bug/故事
• update_work_item -更新工作项字段
• add_work_item_comment -添加讨论评论
• link_work_item -链接工作项（父/子/相关）

仓库和分支机构

• list_repositories -列出项目中的存储库
• list_branches -列出回购中的分支
• create_branch -从源创建新分支
• list_commits -带过滤器的列表提交
• get_commit -获取提交详细信息
• compare_branches -比较两个分支

日常工作流程

• get_my_work - 复合 -仪表板：我的PR+评论+工作项目

使用示例

每日站会

> "What do I need to work on today?"

Agent uses: get_my_work()

Response includes:
- PRs you created (3 active, 1 draft)
- PRs needing your review (2 pending vote)
- Work items assigned to you (5 tasks, 2 bugs)

代码审查

> "Review PR #1805"

Agent uses: start_review(prId=1805)

Gets in one call:
- PR details (title, description, status, branches)
- All comment threads (23 general + 5 inline)
- Reviewers and their votes
- Changed files overview

然后：

> "Show me the changes to config.ts"

Agent uses: get_file_diff(prId=1805, path="config.ts")

Returns side-by-side diff with line numbers

处理反馈

> "Reply 'Fixed indentation' and mark thread 12345 as resolved"

Agent uses: address_comment(
  prId=1805,
  threadId=12345,
  reply="Fixed indentation",
  status="fixed"
)

One call handles both reply and status update

批准和合并

> "Approve PR #1805 and merge if ready"

Agent uses: quick_approve(prId=1805)

One call:
1. Approves PR (vote=10)
2. Checks merge requirements
3. Merges if all policies pass
4. Or tells you what's blocking

从反馈中创造工作

> "Create a bug for the memory leak in thread 12345"

Agent uses:
1. list_comments(prId=1805) to get thread details
2. create_work_item(
     type="Bug",
     title="Memory leak in cache handler",
     description="Details from PR review..."
   )
3. link_work_item(workItemId=123, prId=1805)

Three calls link bug to the PR discussion

设计理念

代理优先

每个工具响应包括：

• 当前状态 -现在发生了什么
• 统计 -快速指标
• 阻碍 -是什么阻碍了进展（如果有的话）
• 建议的行动 -接下来如何使用精确的工具名称

代币高效

响应有级别：

• 总结 （约200个令牌）-快速状态检查
• 标准 （约800个代币）-最常用
• 详细的 （约3000个代币）-当代理需要一切时

帮助的错误消息

错误告诉代理如何解决问题：

{
  "error": {
    "code": "MERGE_BLOCKED",
    "blockers": [
      {
        "reason": "Insufficient approvals (1/2)",
        "howToFix": "Call vote_on_pr(vote=10) to approve",
        "relatedTools": ["vote_on_pr"]
      }
    ]
  }
}

发展

git clone https://github.com/om-surushe/efficient-ado.git
cd efficient-ado
npm install
npm run build

状态

• \[x\] 第一阶段： 基础+设置
• \[x\] 第二阶段： 拉取请求工作流（15个工具）
• \[x\] 第三阶段： 工作项目（6个工具）
• \[x\] 第四阶段： repo和分支（6个工具）
• \[x\] 第五阶段： 公关创建和更新（4个工具）
• \[x\] 第6阶段： 复合工作流（2个工具）

总计： 34个工具已完成并准备就绪！ 🎉

未来的增强功能

• \[\]管道/构建工具
• \[\]团队/项目管理
• \[\]Wiki/文档工具
• \[\]工件管理
• \[\]测试计划集成

许可证

MIT许可证-请参阅 许可证 了解详情。

作者

Om Surushe

• github： @om-surushe
• npm： @om-surushe

相关包

• @om surushe/高效ticktick -LLM优化TickTick任务管理
• @om-surushe/高效搜索 -LLM优化的网络搜索

______________________________________________________________________

部分 高效MCP 系列-用于AI助手的LLM优化工具。