MCP 服务器

Azure DevOps MCP Server

一个模型上下文协议服务器，它使 AI 助手能够通过标准化协议与 Azure DevOps 资源进行交互，这些资源包括项目、工作项、存储库、拉取请求、分支和管道。

Tools

list_organizations

List all Azure DevOps organizations accessible to the current authentication

list_projects

List all projects in an organization

get_project

Get details of a specific project

get_project_details

Get comprehensive details of a project including process, work item types, and teams

get_work_item

Get details of a specific work item

list_work_items

List work items in a project

create_work_item

Create a new work item

update_work_item

Update an existing work item

manage_work_item_link

Add or remove a link between work items

get_repository

Get details of a specific repository

get_repository_details

Get detailed information about a repository including statistics and refs

list_repositories

List repositories in a project

search_code

Search for code across repositories in a project

search_wiki

Search for content across wiki pages in a project

search_work_items

Search for work items across projects in Azure DevOps

README

Azure DevOps MCP 服务器

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

概述

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

访问和管理项目、工作项、存储库等
创建和更新工作项、分支和拉取请求
通过自然语言执行常见的 DevOps 工作流程
安全地验证和与 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", "@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。有关详细的设置说明、配置示例和故障排除提示，请参阅身份验证指南。

支持的身份验证方法

个人访问令牌 (PAT) - 简单的基于令牌的身份验证
Azure 身份 (DefaultAzureCredential) - 使用 Azure 身份 SDK 的灵活身份验证
Azure CLI - 使用您的 Azure CLI 登录进行身份验证

每种身份验证方法的示例配置文件都可以在 examples directory 中找到。

环境变量

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

关键环境变量包括：

变量	描述	是否必需	默认值
`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