Azure DevOps MCP Server

Azure DevOps MCP 服务

Azure DevOps 的模型上下文协议（MCP）服务实现，允许 AI 助手通过标准化协议与 Azure DevOps API 交互。

概述

此服务为 Azure DevOps 实现了模型上下文协议（MCP），使 Claude 等 AI 助手能够安全地与 Azure DevOps 资源交互。该服务充当 AI 模型与 Azure DevOps API 之间的桥梁，提供标准化方式来：

• 访问和管理项目、工作项、存储库等
• 创建和更新工作项、分支和拉取请求
• 通过自然语言执行常见的 DevOps 工作流
• 通过标准化的资源 URI 访问存储库内容
• 安全地进行身份验证并与 Azure DevOps 资源交互

服务结构

此服务围绕模型上下文协议（MCP）构建，用于与 AI 助手通信。它提供了用于与 Azure DevOps 资源交互的工具，包括：

• 项目
• 工作项
• 存储库
• 拉取请求
• 分支
• 流水线

核心组件

• AzureDevOpsServer：初始化 MCP 服务并注册工具的主服务类
• 工具处理程序：用于各项 Azure DevOps 操作的模块化函数
• 配置：基于环境变量配置组织 URL、PAT 等

开始使用

先决条件

• Node.js（v16+）
• npm 或 yarn
• 拥有相应访问权限的 Azure DevOps 帐户
• 身份验证凭据（详见身份验证指南）：
  • 个人访问令牌（PAT），或
  • Azure Identity 凭据，或
  • Azure CLI 登录

使用 NPX 运行

在 Claude Desktop/Cursor AI 中使用

若要集成 Claude Desktop 或 Cursor AI，请将以下任一配置添加到配置文件中。

Azure Identity 身份验证

请先使用 az login 登录 Azure CLI，然后添加以下内容：

{
  "mcpServers": {
    "azureDevOps": {
      "command": "npx",
      "args": ["-y", "@ramosjuan24/mcp-server-azure-devops"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization",
        "AZURE_DEVOPS_AUTH_METHOD": "azure-identity",
        "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name"
      }
    }
  }
}

个人访问令牌（PAT）身份验证

{
  "mcpServers": {
    "azureDevOps": {
      "command": "npx",
      "args": ["-y", "@ramosjuan24/mcp-server-azure-devops"],
      "env": {
        "AZURE_DEVOPS_ORG_URL": "https://dev.azure.com/your-organization",
        "AZURE_DEVOPS_AUTH_METHOD": "pat",
        "AZURE_DEVOPS_PAT": "<YOUR_PAT>",
        "AZURE_DEVOPS_DEFAULT_PROJECT": "your-project-name"
      }
    }
  }
}

有关详细的配置说明和更多身份验证选项，请参阅身份验证指南。

身份验证方法

此服务支持多种身份验证方法，以连接 Azure DevOps API。有关详细的设置说明、配置示例和故障排除提示，请参阅身份验证指南。

支持的身份验证方法

1. 个人访问令牌（PAT） - 简单的基于令牌的身份验证
2. Azure Identity（DefaultAzureCredential） - 使用 Azure Identity SDK 进行灵活身份验证
3. Azure CLI - 使用 Azure CLI 登录进行身份验证

每种身份验证方法的配置文件示例均可在示例目录中找到。

环境变量

如需查看环境变量及其说明的完整列表，请参阅身份验证指南。

主要环境变量包括：

变量	说明	必需	默认值
AZURE_DEVOPS_AUTH_METHOD	身份验证方法（pat、azure-identity 或 azure-cli），不区分大小写	否	azure-identity
AZURE_DEVOPS_ORG_URL	Azure DevOps 组织的完整 URL	是	-
AZURE_DEVOPS_PAT	个人访问令牌（用于 PAT 身份验证）	仅用于 PAT 身份验证	-
AZURE_DEVOPS_DEFAULT_PROJECT	未指定项目时使用的默认项目	否	-
AZURE_DEVOPS_API_VERSION	要使用的 API 版本	否	最新
AZURE_TENANT_ID	Azure AD 租户 ID（用于服务主体）	仅用于服务主体	-
AZURE_CLIENT_ID	Azure AD 应用程序 ID（用于服务主体）	仅用于服务主体	-
AZURE_CLIENT_SECRET	Azure AD 客户端密钥（用于服务主体）	仅用于服务主体	-
LOG_LEVEL	日志级别（debug、info、warn、error）	否	info

身份验证故障排除

如需了解各种身份验证方法的详细故障排除信息，请参阅身份验证指南。

常见问题包括：

• 凭据无效或已过期
• 权限不足
• 网络连接问题
• 配置错误

身份验证实现细节

如需了解 Azure DevOps MCP 服务的身份验证实现技术细节，请参阅身份验证指南以及 src/auth 目录中的源代码。

可用工具

Azure DevOps MCP 服务提供多种工具，用于与 Azure DevOps 资源交互。各工具的详细文档请参阅对应文档。

用户工具

• get_me：获取已通过身份验证的用户详情（id、displayName、email）

组织工具

• list_organizations：列出所有可访问的组织

项目工具

• list_projects：列出组织中的所有项目
• get_project：获取特定项目的详情
• get_project_details：获取项目的全面详情，包括流程、工作项类型和团队

存储库工具

• list_repositories：列出项目中的所有存储库
• get_repository：获取特定存储库的详情
• get_repository_details：获取存储库的详细信息，包括统计数据和 refs
• get_file_content：获取存储库中文件或目录的内容

工作项工具

• get_work_item：通过 ID 检索工作项
• create_work_item：创建新的工作项
• update_work_item：更新现有工作项
• list_work_items：列出项目中的工作项
• manage_work_item_link：添加、移除或更新工作项之间的链接

搜索工具

• search_code：在项目的各个仓库中搜索代码
• search_wiki：在项目的各个 Wiki 页面中搜索内容
• search_work_items：在 Azure DevOps 的各个项目中搜索工作项

管道工具

• create_pipelines：在项目中创建管道 @Juan Ramos
• list_pipelines：列出项目中的管道
• get_pipeline：获取特定管道的详细信息
• trigger_pipeline：使用可自定义的参数触发管道运行

Wiki 工具

• get_wikis：列出项目中的所有 Wiki
• get_wiki_page：以纯文本形式获取特定 Wiki 页面的内容

拉取请求工具

• create_pull_request：在仓库的分支之间创建新的拉取请求
• list_pull_requests：列出并筛选项目或仓库中的拉取请求

如需查看所有工具的完整文档，请参阅工具文档。

贡献

欢迎贡献！有关贡献指南，请参阅 CONTRIBUTING.md。

许可证

MIT