关键词

Azure DevOpsDevOps集成工作项管理代码仓库项目管理

使用说明

项目简介

Azure DevOps MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务，旨在为 AI 助手和智能工具提供与 Azure DevOps 交互的能力。通过此服务器，AI 可以安全、标准化地访问和操作 Azure DevOps 中的工作项、代码仓库、项目信息等，从而实现更智能化的 DevOps 流程集成。

主要功能点

  • 工作项管理: 支持查询、创建、更新、分配、评论和关联 Azure DevOps 工作项，方便 AI 助手进行任务管理和跟踪。
  • Boards & Sprints: 允许 AI 访问和操作 Azure Boards 和 Sprints，包括看板信息、Sprint 计划和团队成员，辅助敏捷开发流程。
  • 项目管理: 提供项目列表、项目详情、创建项目、区域和迭代管理等功能，帮助 AI 理解和管理 Azure DevOps 项目结构。
  • Git 代码仓库: 支持代码仓库的浏览、搜索、分支管理和 Pull Request 操作，使 AI 能够进行代码分析、版本控制和协作。
  • AI 辅助开发工具: 集成 AI 代码审查、代码优化建议、代码异味检测等工具，提升开发效率和代码质量。

安装步骤

  1. 安装 Node.js 和 TypeScript: 确保您的开发环境中已安装 Node.js (v16 或更高版本) 和 TypeScript (v4 或更高版本)。
  2. 克隆仓库: 使用 Git 克隆 AzureDevOps-MCP 仓库到本地： 
    git clone https://github.com/RyanCardin15/AzureDevOps-MCP.git
cd AzureDevOps-MCP
  3. 安装依赖: 在仓库根目录下运行 npm 命令安装项目依赖： 
    npm install
  4. 配置环境变量:
    • 在仓库根目录下创建 '.env' 文件，或直接设置系统环境变量。
    • 填写 Azure DevOps 组织 URL、个人访问令牌 (PAT) 和默认项目： 
      AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-organization
AZURE_DEVOPS_PERSONAL_ACCESS_TOKEN=your-personal-access-token
AZURE_DEVOPS_PROJECT=your-default-project
    • 获取个人访问令牌 (PAT)：
      • 访问您的 Azure DevOps 组织。
      • 点击右上角用户头像，选择 "Personal access tokens"。
      • 点击 "New Token"，填写令牌描述，并选择以下 Scope 权限：
        • Work Items: Read & Write
        • Code: Read & Write
        • Project and Team: Read & Write
        • Build: Read
        • Release: Read
      • 创建令牌并复制保存。
  5. 构建项目: 运行 npm 命令构建 TypeScript 项目： 
    npm run build
  6. 启动服务器: 运行 npm 命令启动 MCP 服务器： 
    npm run start

服务器配置

以下 JSON 配置信息用于 MCP 客户端连接 Azure DevOps MCP Server。您需要将此配置添加到您的 MCP 客户端中。

{
  "serverName": "azure-devops-mcp",
  "command": "npm",
  "args": ["run", "start"],
  "description": "Azure DevOps MCP Server",
  "transport": "stdio"
}

配置参数说明:

  • serverName: 服务器名称，可以自定义，用于在 MCP 客户端中标识该服务器。例如: "azure-devops-mcp"。
  • command: 启动服务器的命令。由于本项目使用 npm 运行，此处填写 "npm"。
  • args: 启动命令的参数，以数组形式提供。本项目使用 'npm run start' 启动服务器，因此此处填写 '["run", "start"]'。
  • description: 服务器的描述信息，方便用户了解服务器用途。例如: "Azure DevOps MCP Server"。
  • transport: MCP 服务器使用的传输协议。本项目使用 Stdio (标准输入输出) 协议，此处填写 "stdio"。

基本使用方法

  1. 确保 Azure DevOps MCP Server 已成功启动并运行。
  2. 在您的 MCP 客户端（例如 Smithery 等）中，添加并配置上述服务器配置信息。
  3. 客户端成功连接服务器后，即可使用预定义的工具与 Azure DevOps 进行交互。
  4. 通过 MCP 客户端发送符合 MCP 协议的 JSON-RPC 请求，调用 Azure DevOps MCP Server 提供的各项工具功能。
  5. 服务器将处理请求并返回 JSON-RPC 响应，AI 助手或智能工具可以解析响应内容，获取 Azure DevOps 的上下文信息或执行操作。
  6. 具体工具的使用方法和参数，请参考仓库 'README.md' 文件中 "Usage" 部分的示例，以及 'src/Interfaces' 目录下定义的接口文档。

信息

分类

开发者工具

访问项目