@om surushe/高效ado
LLM为AI助手优化了Azure DevOps工作流
](https://www.npmjs.com/package/@om-surushe/efficient-ado)    ](https://nodejs.org/)
高效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 # optionalPAT要求:
- 代码(读写)
- 拉取请求线程(读写)
- 工作项(读写)
使用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-使用工作项、审阅者、自动完成创建PRupdate_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优化工具。
