项目简介

MCP Azure DevOps Bridge 是一个基于 Model Context Protocol (MCP) 的服务器实现,它充当 LLM 客户端和 Azure DevOps 之间的桥梁。通过此服务器,LLM 能够以标准化的方式访问和操作 Azure DevOps 中的各种资源,例如工作项、Wiki 文档和 Sprint 计划等,从而实现更智能的项目管理和协作。

主要功能点

  • 工作项管理: 创建、更新、查询和管理 Azure DevOps 中的工作项(如用户故事、Bug、任务等)。支持字段更新、工作项链接、标签管理、附件管理和评论管理。
  • Wiki 文档操作: 创建、更新、检索和搜索 Azure DevOps Wiki 页面。支持列出 Wiki 页面、获取页面内容、管理页面内容和搜索 Wiki 内容。
  • Sprint 计划查询: 获取当前 Sprint 的信息以及列出项目中的 Sprint。
  • 附件和评论: 为工作项添加和检索附件,以及添加和查看工作项的评论。
  • 工作项模板: 获取工作项模板并基于模板创建工作项。
  • 批量操作: 支持批量创建和更新工作项,提高效率。

安装步骤

  1. 安装 Go 1.23 或更高版本

    请根据您的操作系统(Windows 或 macOS)选择合适的安装方式,并验证 Go 版本:

    go version
  2. 构建项目

    克隆仓库并使用 'go build' 命令编译项目:

    git clone https://github.com/krishh-amilineni/mcp-azuredevops-bridge.git
    cd mcp-azuredevops-bridge
    go build
  3. 配置环境变量

    设置以下环境变量,以便服务器连接到您的 Azure DevOps 组织和项目:

    export AZURE_DEVOPS_ORG="your-org"      # 您的 Azure DevOps 组织名称
    export AZDO_PAT="your-pat-token"         # 您的 Azure DevOps 个人访问令牌 (PAT)
    export AZURE_DEVOPS_PROJECT="your-project" # 您的 Azure DevOps 项目名称

    注意: 'AZDO_PAT' 需要具有访问 Azure DevOps 组织和项目的相应权限。

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令才能连接。以下是 'azuredevops-bridge' 服务器的典型配置信息(JSON 格式),您需要将其添加到 MCP 客户端的配置文件中(例如 Windsurf 或 Cursor 的配置):

{
  "mcpServers": {
    "azuredevops-bridge": {  // 服务器名称,可以自定义
      "command": "/full/path/to/mcp-azuredevops-bridge/mcp-azuredevops-bridge", // MCP 服务器可执行文件的完整路径,请替换为实际路径
      "args": [], // 启动参数,此服务器不需要额外的启动参数
      "env": {  // 环境变量配置
        "AZURE_DEVOPS_ORG": "your-org",       //  Azure DevOps 组织名称 (请替换为您的组织名称)
        "AZDO_PAT": "your-pat-token",          //  Azure DevOps 个人访问令牌 (PAT) (请替换为您的 PAT)
        "AZURE_DEVOPS_PROJECT": "your-project" // Azure DevOps 项目名称 (请替换为您的项目名称)
      }
    }
  }
}

请注意:

  • 请将 'command' 字段中的 '/full/path/to/mcp-azuredevops-bridge/mcp-azuredevops-bridge' 替换为 'mcp-azuredevops-bridge' 可执行文件在您系统中的实际完整路径。
  • 'env' 字段中的 'AZURE_DEVOPS_ORG', 'AZDO_PAT', 'AZURE_DEVOPS_PROJECT' 的值需要替换为您在 安装步骤 3 中设置的实际值。

基本使用方法

  1. 启动 MCP Azure DevOps Bridge 服务器。
  2. 在 MCP 客户端(如 Windsurf 或 Cursor)中配置并连接到 'azuredevops-bridge' 服务器。
  3. 使用自然语言指令,通过 MCP 客户端指示 LLM 调用 Azure DevOps 的功能。例如:
    • "Create a user story for the new authentication feature in Azure DevOps" (创建用户故事)
    • "Get the content of the 'Getting Started' page from the wiki" (获取 Wiki 页面内容)
    • "Show me the current sprint's work items and their status" (显示当前 Sprint 的工作项和状态)
    • "Add this screenshot as an attachment to work item #123" (为工作项添加附件)

LLM 将根据指令调用 MCP 服务器提供的工具,与 Azure DevOps 进行交互,并返回结果。

信息

分类

开发者工具