Azure DevOps MCP 服务器

这是一个为 Azure DevOps 实现的模型上下文协议 (MCP) 服务器，允许 AI 助手通过标准化协议与 Azure DevOps API 进行交互。

概览

该服务器实现了 模型上下文协议 (MCP)，使像 Claude 这样的 AI 助手能够安全地与 Azure DevOps 资源进行交互。服务器充当 AI 模型和 Azure DevOps API 之间的桥梁，提供了一种标准化的方式来：

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

服务器结构

该服务器围绕着用于与 AI 助手通信的模型上下文协议 (MCP) 构建。它提供了与 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", "@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": "<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 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: 在项目的Wiki页面中搜索内容
• search_work_items: 在Azure DevOps的项目中搜索工作项

有关所有工具的完整文档，请参阅工具文档。

贡献

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

Star 历史

许可证

MIT