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", "@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 登录进行身份验证

每个身份验证方法的示例配置文件都位于示例目录中。

环境变量

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

关键环境变量包括：

变量	描述	是否必填	默认值
`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、电子邮件）

组织工具

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 - 列出代码库中的拉取请求
add_pull_request_comment - 向拉取请求添加评论
get_pull_request_comments - 获取拉取请求的评论
update_pull_request - 更新现有拉取请求（标题、描述、状态、草稿状态、审阅者、工作项）

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

贡献

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

Star 历史

许可证

MIT