Azure DevOps工作项管理工具

一个将Azure DevOps工作项管理工具暴露给AI助手的MCP服务器,可直接在IDE的AI聊天中搜索、检查和更新工作项。

  • by PierreAlvim
  • C#
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 PierreAlvim/ya-azure-mcp

使用说明

雅蔚蓝mcp

🇺🇸 英语 | 🇧🇷 葡萄牙语

一个MCP(模型上下文协议)服务器,向AI助手公开Azure DevOps工作项管理工具。直接从IDE的AI聊天中搜索、检查和更新工作项。

可用工具

工具 说明
搜索工作项 运行WIQL查询以查找工作项。返回ID、标题、状态、受让人、类型、区域、迭代和标记。
GetWorkItem 按ID获取单个工作项的完整详细信息,包括描述、验收标准、板列和优先级。
创建工作项 通过指定新工作项的项目、类型、标题和可选描述来创建新工作项。
列表存储库 列出项目中或整个组织中的Git存储库。返回存储库ID、名称和URL
ListPullRequests 按状态列出特定存储库的拉取请求(active, completed, abandoned, all).
GetPullRequest 获取单个拉取请求的详细信息,包括其描述和完整的审阅者列表/投票。
CreatePullRequest 在存储库中的两个分支之间创建新的拉取请求。
列表提交 列出存储库中最近的提交。可以选择按分支名称进行筛选。
列表维基 列出Azure DevOps项目中配置的所有wiki。
获取维基页面 按路径获取特定wiki页面的markdown内容。
已创建或更新 创建一个新的wiki页面或使用markdown内容更新现有页面。

设置

1.创建个人访问令牌(PAT)

首选 https://dev.azure.com/{your-org}/_usersSettings/tokens 并创建PAT 工作项→ 读与写 范围。

2.连接到IDE

您可以通过环境变量或命令行参数提供配置(建议用于 mcp.json 配置)。

选项A:独立可执行文件(建议非.NET用户使用)

如果你从GitHub Release下载了预编译的二进制文件(例如。, ya-azure-mcp.exe),您可以将IDE配置为直接指向它,并将设置作为参数传递。

VS代码/光标(.vscode/mcp.json 或全局配置):

{
  "mcpServers": {
    "ya-azure-mcp": {
      "command": "/path/to/extracted/ya-azure-mcp",
      "args": [
        "--AZDO_ORG_URL", "https://dev.azure.com/your-org",
        "--AZDO_PAT", "your-pat-here"
      ]
    }
  }
}

选项B:从源代码运行(需要.NET)

如果要克隆此存储库或处理源代码,可以使用 .NET CLI 以运行MCP服务器。

VS代码/光标(.vscode/mcp.json):

{
  "mcpServers": {
    "ya-azure-mcp": {
      "command": "dotnet",
      "args": [
        "run",
        "--project",
        "/path/to/ya-azure-mcp",
        "--",
        "--AZDO_ORG_URL", "https://dev.azure.com/your-org",
        "--AZDO_PAT", "your-pat-here"
      ]
    }
  }
}

注意:您也可以使用 env 对象在 mcp.json 通过 "AZDO_ORG_URL" 和 "AZDO_PAT" 如果你不想使用命令行参数。

示例提示

连接MCP服务器后,在AI聊天中尝试以下提示:

  • “显示MyProject项目中的所有活动错误”
  • “获取工作项#1234的详细信息”
  • “将工作项#1234移动到活动状态”
  • “将工作项#5678分配给user@example.com"
  • “查找当前sprint中的所有用户故事”
  • “在MyProject项目中创建一个名为“Firefox登录失败”的新Bug”
  • “列出前端项目中的所有git存储库”
  • “在中显示活动的拉取请求 core-api 存储库”
  • “获取PR#998的详细信息,并告诉我谁还没有批准它”
  • “在中创建拉取请求 my-repo 从 feature/new-login 到 main"
  • “最后10次提交是什么 main 分支 web-app?"
  • “列出后端项目中可用的所有Wiki”
  • “获取内容 /Architecture/Database 维基页面”
  • “在 docs wiki下 /Setup/Database 使用文本“运行docker compose up”

发展

# Restore and build
dotnet build

# Run the MCP server locally
dotnet run

详细信息