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身份凭证，或
  • Azure CLI登录

使用NPX运行

与Claude Desktop/Cursor AI集成使用

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

Azure身份认证

确保您已使用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身份（DefaultAzureCredential） - 使用Azure身份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：获取仓库的详细信息，包括统计信息和引用
• get_file_content：从仓库中获取文件或目录的内容

工作项工具

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

搜索工具

• search_code：跨项目中的仓库搜索代码
• search_wiki：跨项目中的维基页面搜索内容
• search_work_items：跨Azure DevOps中的项目搜索工作项

管道工具

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

维基工具

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

拉取请求工具

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

关于所有工具的综合文档，请参阅工具文档。

贡献

欢迎贡献！请参阅CONTRIBUTING.md了解贡献指南。

许可证

MIT