DevOps MCP适配器🚀
定制模型上下文协议(MCP)服务器,专门用于连接AI助手(如Claude或Cursor)与 Azure DevOps服务器(本地) 以及Azure DevOps服务部署。
与官方不同 @azure-devops/mcp 服务器,此适配器通过直接与Azure DevOps REST API交互以进行特定的通用操作,从而绕过自动API发现问题。
✨ 特性
- 零位置发现错误: 专为本地兼容性而构建。
- 动态API版本控制: 选择与服务器匹配的API版本(默认为7.1)。
- 完整层次结构支持: 创建任务并将其作为儿童/家长/相关项目链接到用户故事或功能。
- 智能查询(WIQL): 使用带有可选特定列的WIQL语法获取任何项目(
fields)选择。 - 完整CRUD: 使用规范化的属性结构有效地创建、读取、更新和删除工作项。
- 多项目支持: 与特定项目无关(动态切换)。
______________________________________________________________________
🛠️ 安装与设置(适用于AI助手)
您不需要手动克隆或运行此程序。只需配置您的AI助手(Cursor、Claude Desktop等)即可通过以下方式使用此工具 npx!
- 将以下内容添加到MCP配置文件中(例如。
mcp_config.json):
{
"mcpServers": {
"devops-mcp-adapter": {
"command": "npx",
"args": ["-y", "github:dsquintero/devops-mcp-adapter"],
"env": {
"AZURE_DEVOPS_ORG_URL": "https://your-devops-server.com/CollectionName",
"AZURE_DEVOPS_PROJECT": "Your.Project.Name.Here",
"AZURE_DEVOPS_API_VERSION": "7.1",
"AZURE_DEVOPS_PAT": "YOUR_PERSONAL_ACCESS_TOKEN"
}
}
}
}注: 所有4个环境变量(ORG_URL,PROJECT,API_VERSION,PAT)上面提到的是 必需的 启动服务器。
需求
- 你的Azure DevOps 个人访问令牌(PAT) 必须拥有
Read & Write范围 工作项. - Node.js已安装在您的计算机上(
npx是必需的)。
______________________________________________________________________
🤖 可用的AI工具
一旦连接,您的AI将可以访问以下操作:
get_work_item:按ID检索特定工作项的详细信息,可选择按以下方式进行筛选fields.query_work_items:执行WIQL查询以查找任务、故事或错误,选择特定的fields如果需要的话。create_work_item:创建任何类型的工作项并无缝分配(分离系统和自定义字段)。update_work_item:通过标准属性或自定义字段映射轻松更新现有工作项。delete_work_item:按ID删除现有工作项。create_child_task:立即创建任务并将其链接(如Child)到父用户故事/功能。link_work_items:使用以下方式将现有项目相互连接Child,Parent,或Related关系。add_hours:逐步将您的小时数添加或记录到Completed Work现场。
