az-deops-cli-mcp
Azure DevOps MCP工具 克劳德代码 和 Codex CLI --板、工作项、repo和PR。
______________________________________________________________________
安装并注册
# 1. Install
pip install az-devops-cli-mcp
# 2. Login (once per machine)
az login
az devops configure --defaults organization=https://dev.azure.com/YOUR_ORG
# 3. Register with Claude Code
claude mcp add az-devops-cli-mcp -- python -m az_devops_cli_mcp.server
# 4. Register with Codex CLI
codex mcp add az-devops-cli-mcp -- python -m az_devops_cli_mcp.server重新启动Claude Code或Codex CLI。所有13个工具都准备好了。
______________________________________________________________________
运作原理
服务器作为 stdio过程 --根据客户端的需求生成，不需要端口或后台服务。
Claude Code / Codex CLI
| spawns on demand
v
python -m az_devops_cli_mcp.server (stdin/stdout)
|
v
az CLI (your az login session)______________________________________________________________________
可用工具（共13个）
工作项
| 工具 | 它做什么 |
|---|---|
create_work_item | 创建任务、Bug、用户故事、Epic |
get_work_item | 按ID获取项目 |
update_work_item | 更新状态、任务、标题 |
set_iteration | 分配给sprint（sprint板需要） |
query_work_items | 用于批量查找的WIQL查询 |
link_work_items | 链接项（子项、父项、相关项） |
get_work_item_relations | 链接后验证层次结构 |
add_comment | 添加讨论评论/代理日志 |
回复/PR
| 工具 | 它做什么 |
|---|---|
list_prs | 按状态列出PR |
get_pr | 获取PR详细信息 |
create_pr | 打开一个新的PR |
link_pr_to_work_item | 将PR跟踪到工作项 |
list_branches | 列出回购分支 |
______________________________________________________________________
AG2用法（可选）
from autogen import ConversableAgent
from az_devops_cli_mcp import ALL_TOOLS, WORK_ITEM_TOOLS, REPO_TOOLS
agent = ConversableAgent(
name="devops_agent",
tools=ALL_TOOLS,
system_message="You manage Azure DevOps for LytStore..."
)______________________________________________________________________
配置
| 方法 | 如何 |
|---|---|
az devops configure | 首选--为您的机器全局设置组织 |
AZURE_DEVOPS_ORG env var | 每个会话覆盖 |
.env 文件 | AZURE_DEVOPS_ORG=https://dev.azure.com/YOUR_ORG |
______________________________________________________________________
安全
破坏性命令(delete, remove, destroy)在芯层处被阻挡。 代理返回错误，需要用户明确确认。
______________________________________________________________________
手动MCP配置（回退）
如果 claude mcp add / codex mcp add 不可用，请手动将其添加到配置文件中。
克劳德代码 — ~/.claude/claude_desktop_config.json:
{
"mcpServers": {
"az-devops-cli-mcp": {
"type": "stdio",
"command": "python",
"args": ["-m", "az_devops_cli_mcp.server"]
}
}
}Codex CLI — ~/.codex/config.json：同一块。
______________________________________________________________________
贡献
git clone https://github.com/PraiseSinkamba/az-devops-cli-mcp
cd az-devops-cli-mcp
pip install -e ".[dev]"
pytest tests/