适用于Cursor的Azure DevOps MCP服务器🚀
专为Cursor IDE构建 -用自然语言控制Azure DevOps！
⚡ 这是什么？
一个工具，可以让你在Cursor的聊天中用简单的英语与Azure DevOps交谈。没有命令要记住！
示例：
- *“显示我的工作项”*
- *“为登录问题创建错误”*
- *“哪些公关需要我审查？”*
- *“运行主构建”*
______________________________________________________________________
🚨 重要提示：尽可能在游标中执行所有操作！ 🚨
本指南假设您正在使用 光标IDE如果你还没有， 在此处下载Cursor.
______________________________________________________________________
📦 安装指南（5分钟）
🎯 第一步：克隆项目 在游标中
- 打开 光标IDE
- 按
Ctrl+Shift+P（或Cmd+Shift+P在Mac上） - 键入“Git:Clone”并选择它
- 粘贴：
https://github.com/EreAlexandru/ADOMCPLocalServer.git - 选择保存位置（记住这个位置！）
- 当光标询问时，单击“打开”
您现在位于Cursor中的项目文件夹中！ ✅
🔨 步骤2：安装依赖项 在游标中
- 在光标中，按 `
Ctrl+`` 打开终端 - 你应该看看这样的东西
C:\...\ADOMCPLocalServer> - 键入以下命令：
npm install
npm run build- 等待其完成（约30秒）
Windows的替代方案： 您也可以双击 install.bat 在文件资源管理器中
🔑 步骤3：获取Azure DevOps令牌
- 打开浏览器并转到：
https://dev.azure.com/YOUR-ORG-NAME/_usersSettings/tokens替换 YOUR-ORG-NAME 与您的组织合作！
📍 如何查找您的组织名称：
- 查看您的Azure DevOps URL - 如果是 https://dev.azure.com/contoso/MyProject → org是 contoso - 如果是 https://contoso.visualstudio.com/ → org是 contoso
- 点击 “+新令牌”
- 命名为：“光标MCP”
- 有效期：90天（推荐）
- 范围：点击 “自定义” 然后检查：
- ✅ 工作项（读、写和管理） - ✅ 代码（读取） - ✅ 构建（读取并执行） - ✅ 释放（读取、写入和执行） - ✅ 测试管理（读写） - ✅ Wiki（读写）
- 点击 “创建”
- 立即复制令牌！ 你不会再看到它了！
🔐 步骤4：创建.env文件 在正确的地方！
⚠️ 关键：.env文件位于ROOT文件夹中，而不是src/或dist/！ ⚠️
选项A：使用光标（推荐） 👈
- 在光标中，右键单击 根文件夹 （ADOMPClocalServer）
- 选择“新建文件”
- 准确命名：
.env（是的，从一个点开始！） - 粘贴此内容（替换为您的值）：
AZURE_DEVOPS_ORG=your-organization-name
AZURE_DEVOPS_PAT=your-token-from-step-3- 保存方式
Ctrl+S
选项B：使用setup.bat（仅限Windows）
- 双击
setup.bat在根文件夹中 - 当被询问时，请输入您的组织名称
- 在被询问时粘贴您的令牌
- 它为您创建.env文件！
选项C：手动（如果上述不起作用）
- 打开记事本
- 粘贴：
AZURE_DEVOPS_ORG=your-organization-name
AZURE_DEVOPS_PAT=your-token-here- File → 另存为
- 导航到ADOMCLocalServer文件夹（不是src或dist！）
- 文件名：
.env（带圆点！） - 另存为类型： **所有文件(*.*)**
- 单击保存
📁 正确的文件结构：
ADOMCPLocalServer/
├── .env ← YOUR .ENV FILE GOES HERE!
├── src/ ← NOT HERE!
├── dist/ ← NOT HERE!
├── package.json
├── install.bat
└── README.md🔌 步骤5：连接到游标
- 在光标中，转到 File → 偏好设置→ 光标设置
- 在左侧边栏中，找到 “工具与集成”
- 点击 “新建MCP服务器”
- 删除所有内容 在框中粘贴以下内容：
{
"mcpServers": {
"azure-devops": {
"command": "node",
"args": ["C:/PATH/TO/YOUR/ADOMCPLocalServer/dist/index.js"]
}
}
}- 重要： 替换
C:/PATH/TO/YOUR/与你的实际路径！
如何找到自己的路：
- 在Cursor中，查看窗口顶部 - 或者右键单击任何文件→ “复制路径” - 使用正向斜线（/）而不是反斜线（）
示例：
- ✅ 窗户： "C:/Users/John/Projects/ADOMCPLocalServer/dist/index.js" - ✅ 雨衣： "/Users/john/Projects/ADOMCPLocalServer/dist/index.js" - ❌ 错误： "C:\Users\John\..." （反睫毛不起作用！）
- 单击框外以保存
🔄 步骤6：重新启动游标
这是必需的！ 完全关闭光标，然后重新打开。
✅ 步骤7：验证它是否有效
- 重新启动后，转到 File → 偏好设置→ 光标设置→ 工具和集成
- 在列表中找到“azure devops”
- 你应该看到一个绿点✅ =已连接！
- 点击查看所有60+可用工具
没有绿点？ 看 故障排除
🎉 第八步：测试一下！
- 在Cursor中打开新聊天（Ctrl+L）
- 类型：“列出我的Azure DevOps项目”
- 你应该看看你的项目！
______________________________________________________________________
🆘 故障排除
🔍 快速诊断（Windows）
双击 check-env.bat 自动检查您的设置！
❌ 常见问题
“无绿点/未连接”
- 添加服务器后是否重新启动了Cursor？
- 您的路径设置正确吗？（正斜杠！）
- 你跑了吗
npm run build? - .env文件是否在ROOT文件夹中？
“身份验证失败”
- 检查.env文件的位置（必须在根文件夹中！）
- 您的组织名称拼写正确吗？
- 你复制了整个令牌吗？
- 你的代币过期了吗？
“找不到.env文件”
- .env文件应位于ROOT文件夹中：
ADOMCPLocalServer/.env ← HERE!
NOT in:
- ADOMCPLocalServer/src/.env ❌
- ADOMCPLocalServer/dist/.env ❌要验证.env位置，请执行以下操作：
- 在游标终端中，键入：
dir .env（Windows）或ls -la .env（Mac/Linux） - 您应该看到列出的文件
🧪 测试您的连接
在Cursor终端中运行以下命令：
node test-connection.js这将显示：
- ✅ 如果您的凭据有效
- 📁 您可以访问哪些项目
- ❌ 任何连接错误
______________________________________________________________________
💬 你可以问什么
只需在Cursor的聊天中自然键入：
日常任务：
- “显示我的活动工作项”
- “我昨天做了什么？”
- “为登录问题创建错误”
代码审查：
- “显示等待我审核的PR”
- “从功能/登录到主页创建PR”
- “哪些PR超过3天？”
构建和发布：
- “运行CI构建”
- “显示从今天开始的失败构建”
- “将发布部署到暂存”
Sprint管理：
- “显示冲刺23进度”
- “哪些项目被阻止？”
- “计算团队速度”
______________________________________________________________________
🎪 高级：引导式工作流
寻求复杂任务的帮助：
👥 对于开发团队：
- “帮我准备站起来”
- “指导我完成冲刺计划”
- “显示冲刺回顾数据”
- “分析构建健康状况”
🧪 对于QA手动测试人员：
- “显示测试执行状态”
- “分析失败的测试模式”
- “生成测试覆盖率报告”
- “检查测试环境健康状况”
🤖 QA自动化工程师：
- “在自动化中查找不稳定的测试”
- “分析自动化测试结果”
- “确定需要自动化的测试”
- “显示性能测试趋势”
🚀 对于发布管理：
- “检查释放准备情况”
- “分析缺陷泄漏”
- “审查测试数据要求”
总计：24个指导性工作流程 涵盖开发、手动测试、自动化和发布管理！
AI将逐步指导您完成每个过程！
______________________________________________________________________
🔒 安全
- ✅ 在您的计算机上100%本地运行
- ✅ 你的代币永远不会离开你的机器
- ✅ 只能做你有权限做的事
- ✅ 开源-自己检查代码！
______________________________________________________________________
📝 对于开发者
更改？ 使用以下方式重建：
npm run build然后在游标设置（禁用/启用）中重新启动服务器。
______________________________________________________________________
🐛 还有问题吗？
- 确保您正在使用 光标IDE （非VS代码）
- 检查.env文件是否在 根文件夹
- 使用 正斜杠 在路上
- 重新启动游标 任何更改后
需要帮助？ 打开一个问题：https://github.com/EreAlexandru/ADOMCPLocalServer/issues
______________________________________________________________________
许可证： 麻省理工学院-随心所欲地使用它！ 🎉