使用说明
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/
