Azure DevOps MCP Server

Azure DevOps MCP 服务

此项目实现了一个模型上下文协议（MCP）服务，使 AI 助手能够与 Azure DevOps 交互，以创建和更新工单（工作项）。该服务充当大模型与 Azure DevOps REST API 之间的桥梁，为 AI Agent 提供管理工作项的标准化方式。

概述

模型上下文协议（MCP）是一项开放标准，用于规范应用程序向大语言模型（LLM）提供上下文的方式。它为 LLM 与外部工具和服务交互创建了通用接口，无需在不同的 AI 模型和工具之间进行定制集成。

此 MCP 服务专注于 Azure DevOps 中的工单管理，使 AI 助手能够：

• 创建新的工作项（工单）
• 更新现有工作项
• 为工作项添加评论
• 获取工作项详情

前提条件

• Python 3.10+
• 具有相应权限的 Azure DevOps 账户
• 具有 Azure DevOps API 访问所需范围的个人访问令牌（PAT）

安装

1. 克隆此代码仓库：

   git clone https://github.com/langkurt/azure-devops-mcp-server.git
   cd azure-devops-mcp-server
   

2. 安装所需依赖项：

   pip install -r requirements.txt
   

3. 在项目根目录中创建一个 .env 文件，并添加以下变量：

   AZURE_DEVOPS_PAT=your_personal_access_token
   AZURE_DEVOPS_ORGANIZATION_URL=https://dev.azure.com/your-organization
   AZURE_DEVOPS_DEFAULT_PROJECT=your-default-project
   

   注意：请确保提供 Azure DevOps 组织的完整 URL。

使用方法

运行 MCP 服务

你可以通过以下不同方式运行 MCP 服务：

1. 使用 MCP Inspector 进入开发模式：

   mcp dev main.py
   

2. 安装到 Claude Desktop：

   mcp install main.py --name "Azure DevOps Ticket Manager"
   

3. 直接运行：

   python main.py
   

配置 Claude 或其他 AI 助手

若要将此 MCP 服务配置为与 Claude Desktop 配合使用，请将以下内容添加到 Claude Desktop 配置文件中：

{
  "mcpServers": {
    "azureDevOpsTickets": {
      "command": "python",
      "args": ["path/to/main.py"],
      "env": {
        "AZURE_DEVOPS_PAT": "your_personal_access_token",
        "AZURE_DEVOPS_ORGANIZATION_URL": "https://dev.azure.com/your-organization",
        "AZURE_DEVOPS_DEFAULT_PROJECT": "your-default-project"
      }
    }
  }
}

AI 助手提示词示例

MCP 服务运行并连接到 AI 助手后，你可以使用如下提示词：

• “在 ProjectX 中创建一个 Bug，标题为 ‘Login button not working in Safari’，并分配给 [email protected]”
• “更新工作项 #1234，将其状态改为 ‘Resolved’，并添加一条说明修复内容的评论”
• “获取工作项 #5678 的详情”
• “创建一个用于实现双重身份验证的新用户故事”

可用工具

create_work_item

在 Azure DevOps 中创建一个新的工作项。

参数：

• project：要创建工作项的项目（默认使用 .env 中的值）
• work_item_type：要创建的工作项类型（例如，‘Bug’、‘Task’、‘User Story’）
• title：工作项标题
• description（可选）：工作项描述
• assigned_to（可选）：要分配工作项的人员的电子邮件地址
• state（可选）：工作项的初始状态
• priority（可选）：工作项的优先级
• area_path（可选）：工作项的区域路径
• iteration_path（可选）：工作项的迭代路径
• tags（可选）：以逗号分隔的标签列表

update_work_item

更新 Azure DevOps 中现有的工作项。

参数：

• work_item_id：要更新的工作项 ID
• title（可选）：工作项的新标题
• description（可选）：工作项的新描述
• assigned_to（可选）：要分配工作项的人员的电子邮件地址
• state（可选）：工作项的新状态
• priority（可选）：工作项的新优先级
• area_path（可选）：工作项的新区域路径
• iteration_path（可选）：工作项的新迭代路径
• tags（可选）：以逗号分隔的标签列表

add_work_item_comment

为 Azure DevOps 中现有的工作项添加评论。

参数：

• work_item_id：要添加评论的工作项 ID
• comment：要添加到工作项的评论文本

get_work_item

获取 Azure DevOps 中现有工作项的详情。

参数：

• work_item_id：要获取的工作项 ID

安全注意事项

• 此 MCP 服务需要具有适当 Azure DevOps 组织权限的个人访问令牌（PAT）。
• 请安全地存储 PAT，切勿将其提交到版本控制系统中。
• 应在安全环境中运行此服务，以防止未经授权访问 Azure DevOps 资源。

许可证

此项目基于 MIT 许可证授权，详情请参阅 LICENSE 文件。

致谢

• 感谢 Anthropic 开发 Model Context Protocol
• 感谢 Microsoft 提供 Azure DevOps API
• Azure DevOps Python API
• MCP Python SDK