项目简介

Ares DevOps MCP Server 是一个基于 Model Context Protocol (MCP) 构建的后端服务,旨在为 LLM (大型语言模型) 应用提供与 Azure DevOps 集成的能力。它允许 LLM 客户端通过标准化的 MCP 协议,安全地访问和操作 Azure DevOps 中的资源和功能,例如代码仓库、分支、Pull Request 和 CI/CD 流水线。

主要功能点

  • Azure DevOps 集成: 无缝连接 Azure DevOps,支持对代码仓库、Pull Request 和流水线进行操作。
  • 资源管理: 支持代码仓库和分支的管理,例如创建仓库、列出分支、获取提交历史等。
  • 工具执行: 提供一系列工具,允许 LLM 客户端创建和管理 Pull Request,添加 Pull Request 评论,触发和监控 CI/CD 流水线等。
  • 安全可靠: 通过个人访问令牌 (PAT) 进行身份验证,安全地访问 Azure DevOps 资源。
  • 易于配置: 支持多种 MCP 客户端 (如 Cline, Cursor, Claude Desktop),提供详细的配置指南。

安装步骤

  1. 安装 Node.js 和 npm: 确保你的环境中已安装 Node.js (v14 或更高版本) 和 npm 包管理器。

  2. 安装 Ares DevOps MCP Server: 可以通过 npm 的 npx 命令直接运行,无需全局安装。

    npx -y ares-devops-mcp@latest

    或者,如果使用 Smithery 客户端,可以使用 Smithery CLI 进行安装:

    npx -y @smithery/cli install @ares-devops/mcp --client claude

服务器配置

MCP 客户端需要配置 MCP 服务器的启动命令才能连接到 Ares DevOps MCP Server。以下是针对不同 MCP 客户端的配置示例,配置信息为 JSON 格式:

1. Cline (VS Code 扩展) 配置:

在 Cline MCP 设置文件 'cline_mcp_settings.json' 中添加以下配置:

{
  "mcpServers": {
    "ares-devops-mcp": {  // 服务器名称,用户自定义
      "command": "npx",  // 启动命令,使用 npx 运行 npm 包
      "args": ["-y", "ares-devops-mcp@latest"], // 命令参数,-y 表示自动确认安装,ares-devops-mcp@latest 指定要运行的 npm 包
      "env": {  // 环境变量配置,用于传递 Azure DevOps 凭据
        "AZURE_DEVOPS_ORG": "your-organization",  //  Azure DevOps 组织名称,请替换为你的组织名称
        "AZURE_DEVOPS_PROJECT": "your-project",  // Azure DevOps 项目名称,请替换为你的项目名称
        "AZURE_DEVOPS_PAT": "your-pat-token"  // Azure DevOps 个人访问令牌 (PAT),请替换为你的 PAT
      },
      "disabled": false, //  是否禁用该服务器,false 表示启用
      "autoApprove": [] //  自动批准的工具列表,默认为空
    }
  }
}

2. Cursor (代码编辑器) 配置:

在 Cursor 的 MCP Servers 设置中,添加新的 MCP Server,并填写以下信息:

  • Name: 'ares-devops-mcp' (或其他自定义名称)
  • Type: 'command'
  • Command:
    env AZURE_DEVOPS_ORG=your-org AZURE_DEVOPS_PROJECT=your-project AZURE_DEVOPS_PAT=your-pat npx -y ares-devops-mcp@latest
    请务必将 'your-org', 'your-project', 'your-pat' 替换为你的 Azure DevOps 组织、项目和个人访问令牌。

3. Claude Desktop App 配置:

在 Claude Desktop App 的配置文件 'claude_desktop_config.json' 中添加以下配置:

{
  "mcpServers": {
    "ares-devops-mcp": { // 服务器名称,用户自定义
      "command": "npx", // 启动命令,使用 npx 运行 npm 包
      "args": ["-y", "ares-devops-mcp@latest"], // 命令参数,-y 表示自动确认安装,ares-devops-mcp@latest 指定要运行的 npm 包
      "env": { // 环境变量配置,用于传递 Azure DevOps 凭据
        "AZURE_DEVOPS_ORG": "your-organization", // Azure DevOps 组织名称,请替换为你的组织名称
        "AZURE_DEVOPS_PROJECT": "your-project", // Azure DevOps 项目名称,请替换为你的项目名称
        "AZURE_DEVOPS_PAT": "your-pat-token" // Azure DevOps 个人访问令牌 (PAT),请替换为你的 PAT
      }
    }
  }
}

基本使用方法

成功配置并启动 Ares DevOps MCP Server 后,在 MCP 客户端 (如 Claude Desktop App) 中,你可以使用自然语言指令调用 Azure DevOps 的功能。

示例:

  • 创建代码仓库: 在对话框中输入 'Create a new repository named "my-project" in Azure DevOps.'
  • 创建 Pull Request: 输入 'Create a pull request from "feature-branch" to "main" in repository "my-project" with title "New Feature" and description "Adding new functionality".'
  • 列出流水线: 输入 'List all available pipelines in the project.'
  • 获取提交历史: 输入 'Get the commit history for the "main" branch in repository "my-project".'

客户端会将这些自然语言指令转换为对 MCP 服务器的工具调用,服务器执行相应的 Azure DevOps 操作,并将结果返回给客户端。

注意: 首次使用时,Claude Desktop App 需要完全关闭并重新打开才能识别到新配置的 MCP 服务器。在 Claude Desktop App 的左下角,如果看到锤子图标,则表示 MCP 工具已可用。

信息

分类

开发者工具