Azure Devops (azure-devops)

Azure DevOps MCP服务器

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

概述

此服务器实现 模型上下文协议（MCP） 对于Azure DevOps，使像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或纱线
• 具有适当访问权限的Azure DevOps帐户
• 身份验证凭据（请参阅 身份验证指南 详细信息）：

- 个人访问令牌（PAT），或 - Azure身份凭据，或 - Azure CLI登录

使用NPX运行

使用Claude Desktop/Cursor AI

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

Azure身份验证

请确保您已使用登录到Azure CLI az login 然后添加以下内容：

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

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

身份验证方法

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

支持的身份验证方法

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

每种身份验证方法的示例配置文件可在 示例目录.

环境变量

有关环境变量及其描述的完整列表，请参阅 身份验证指南.

关键环境变量包括：

身份验证故障排除

有关每种身份验证方法的详细故障排除信息，请参阅 身份验证指南.

常见问题包括：

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

身份验证实施详细信息

有关如何在Azure DevOps MCP服务器中实现身份验证的技术详细信息，请参阅 身份验证指南 源代码在 src/auth 目录。

可用工具

Azure DevOps MCP服务器提供了各种与Azure DevOps资源交互的工具。有关每个工具的详细文档，请参阅相应的文档。

用户工具

• get_me：获取经过身份验证的用户的详细信息（id、displayName、电子邮件）

组织工具

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

项目工具

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

存储库工具

• list_repositories：列出项目中的所有存储库
• get_repository：获取特定存储库的详细信息
• get_repository_details：获取有关存储库的详细信息，包括统计数据和参考文献
• 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中跨项目搜索工作项

管道工具

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

Wiki工具

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

拉取请求工具

• create_pull_request：在存储库中的分支之间创建新的拉取请求
• list_pull_requests：列出并过滤项目或存储库中的拉取请求
• get_pull_request_comments：从特定的pull请求中获取评论和评论线程
• add_pull_request_comment：在pull请求中添加评论（回复现有评论或创建新线程）

有关所有工具的全面文档，请参阅 工具文档.

贡献

欢迎投稿！请看 贡献.md 关于贡献指南。

明星历史

许可证

麻省理工学院