Ares DevOps MCP Server 🚀

🔌 兼容 Cline、Cursor、Claude Desktop 以及任何其他 MCP 客户端！

Ares DevOps MCP 也与任何 MCP 客户端兼容。

模型上下文协议（MCP）是一个开放标准，它使 AI 系统能够无缝地与各种数据源和工具进行交互，促进安全的双向连接。

Ares DevOps MCP 服务器提供：

• 与 Azure DevOps Git 仓库无缝交互
• 安全的仓库和分支管理
• 高效的拉取请求创建和管理
• 使用 TypeScript 的类型安全操作
• 流水线自动化和监控

前提条件 🔧

在开始之前，请确保您具备以下条件：

• 具有适当权限的 Azure DevOps 账户
• 具有所需范围的个人访问令牌 (PAT)
• Claude Desktop 或 Cursor
• Node.js (v14 或更高版本)
• 已安装 Git（仅当使用 Git 安装方法时需要）

Ares DevOps MCP 服务器安装 ⚡

使用 NPX 运行

npx -y ares-devops-mcp@latest

通过 Smithery 安装

要通过 Smithery 自动为 Claude Desktop 安装 Ares DevOps MCP 服务器：

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

配置 MCP 客户端 ⚙️

配置 Cline 🤖

在 Cline 中设置 Ares DevOps MCP 服务器最简单的方法是通过市场一键安装：

1. 在 VS Code 中打开 Cline
2. 单击侧边栏中的 Cline 图标
3. 导航到 "MCP Servers" 标签页（四个方块）
4. 搜索 "Ares DevOps" 并单击 "install"
5. 当提示时，输入您的 Azure DevOps 凭证

或者，您可以手动在 Cline 中设置 Ares DevOps MCP 服务器：

1. 打开 Cline MCP 设置文件：

# For macOS:
code ~/Library/Application\ Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

# For Windows:
code %APPDATA%\Code\User\globalStorage\saoudrizwan.claude-dev\settings\cline_mcp_settings.json

1. 将 Ares DevOps 服务器配置添加到文件中：

{
  "mcpServers": {
    "ares-devops-mcp": {
      "command": "npx",
      "args": ["-y", "ares-devops-mcp@latest"],
      "env": {
        "AZURE_DEVOPS_ORG": "your-organization",
        "AZURE_DEVOPS_PROJECT": "your-project",
        "AZURE_DEVOPS_PAT": "your-pat-token"
      },
      "disabled": false,
      "autoApprove": []
    }
  }
}

1. 保存文件。如果 Cline 已经运行，请重启 Cline。

配置 Cursor 🖥️

注意：需要 Cursor 版本 0.45.6 或更高版本

要在 Cursor 中设置 Ares DevOps MCP 服务器：

1. 打开 Cursor 设置
2. 导航至 Features > MCP Servers
3. 单击 "+ Add New MCP Server" 按钮
4. 填写以下信息：
   • 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
   

   重要：请用您的 Azure DevOps 凭证替换环境变量

配置 Claude Desktop 应用程序 🖥️

对于 macOS：

# Create the config file if it doesn't exist
touch "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

# Opens the config file in TextEdit
open -e "$HOME/Library/Application Support/Claude/claude_desktop_config.json"

对于 Windows：

code %APPDATA%\Claude\claude_desktop_config.json

添加 Ares DevOps 服务器配置：

{
  "mcpServers": {
    "ares-devops-mcp": {
      "command": "npx",
      "args": ["-y", "ares-devops-mcp@latest"],
      "env": {
        "AZURE_DEVOPS_ORG": "your-organization",
        "AZURE_DEVOPS_PROJECT": "your-project",
        "AZURE_DEVOPS_PAT": "your-pat-token"
      }
    }
  }
}

在 Claude Desktop 应用程序中使用 🎯

完成安装并配置好 Claude 桌面应用程序后，必须完全关闭并重新打开 Claude 桌面应用程序才能看到 ares-devops-mcp 服务器。您应该会在应用程序左下角看到一个锤子图标，表示可用的 MCP 工具。

Ares DevOps 示例

1. 创建仓库：

Create a new repository named "my-project" in Azure DevOps.

1. 创建拉取请求：

Create a pull request from "feature-branch" to "main" in repository "my-project" with title "New Feature" and description "Adding new functionality".

1. 列出管道:

List all available pipelines in the project.

1. 获取提交历史:

Get the commit history for the "main" branch in repository "my-project".

故障排除 🛠️

常见问题

1. 找不到服务器

   • 通过运行 npm --version 验证 npm 安装
   • 检查 Claude Desktop 配置语法
   • 通过运行 node --version 确保 Node.js 正确安装

2. 认证问题

   • 确认您的 Azure DevOps 个人访问令牌 (PAT) 有效且具有所需权限范围
   • 检查配置中的 PAT 是否正确设置
   • 确认 PAT 周围没有空格或引号

3. 仓库访问问题

   • 确认您的 Azure DevOps 项目中存在该仓库
   • 检查仓库权限
   • 确保 PAT 具有适当的访问权限

致谢 ✨

• MCP 规范的 Model Context Protocol
• Anthropic 提供的 Claude Desktop
• Microsoft Azure DevOps 提供的 API