项目简介
MCP Azure DevOps Bridge 是一个基于 Model Context Protocol (MCP) 的服务器实现,它充当 LLM 客户端和 Azure DevOps 之间的桥梁。通过此服务器,LLM 能够以标准化的方式访问和操作 Azure DevOps 中的各种资源,例如工作项、Wiki 文档和 Sprint 计划等,从而实现更智能的项目管理和协作。
主要功能点
- 工作项管理: 创建、更新、查询和管理 Azure DevOps 中的工作项(如用户故事、Bug、任务等)。支持字段更新、工作项链接、标签管理、附件管理和评论管理。
- Wiki 文档操作: 创建、更新、检索和搜索 Azure DevOps Wiki 页面。支持列出 Wiki 页面、获取页面内容、管理页面内容和搜索 Wiki 内容。
- Sprint 计划查询: 获取当前 Sprint 的信息以及列出项目中的 Sprint。
- 附件和评论: 为工作项添加和检索附件,以及添加和查看工作项的评论。
- 工作项模板: 获取工作项模板并基于模板创建工作项。
- 批量操作: 支持批量创建和更新工作项,提高效率。
安装步骤
-
安装 Go 1.23 或更高版本
请根据您的操作系统(Windows 或 macOS)选择合适的安装方式,并验证 Go 版本:
go version -
构建项目
克隆仓库并使用 'go build' 命令编译项目:
git clone https://github.com/krishh-amilineni/mcp-azuredevops-bridge.git cd mcp-azuredevops-bridge go build -
配置环境变量
设置以下环境变量,以便服务器连接到您的 Azure DevOps 组织和项目:
export AZURE_DEVOPS_ORG="your-org" # 您的 Azure DevOps 组织名称 export AZDO_PAT="your-pat-token" # 您的 Azure DevOps 个人访问令牌 (PAT) export AZURE_DEVOPS_PROJECT="your-project" # 您的 Azure DevOps 项目名称注意: 'AZDO_PAT' 需要具有访问 Azure DevOps 组织和项目的相应权限。
服务器配置
MCP 客户端需要配置 MCP 服务器的启动命令才能连接。以下是 'azuredevops-bridge' 服务器的典型配置信息(JSON 格式),您需要将其添加到 MCP 客户端的配置文件中(例如 Windsurf 或 Cursor 的配置):
{ "mcpServers": { "azuredevops-bridge": { // 服务器名称,可以自定义 "command": "/full/path/to/mcp-azuredevops-bridge/mcp-azuredevops-bridge", // MCP 服务器可执行文件的完整路径,请替换为实际路径 "args": [], // 启动参数,此服务器不需要额外的启动参数 "env": { // 环境变量配置 "AZURE_DEVOPS_ORG": "your-org", // Azure DevOps 组织名称 (请替换为您的组织名称) "AZDO_PAT": "your-pat-token", // Azure DevOps 个人访问令牌 (PAT) (请替换为您的 PAT) "AZURE_DEVOPS_PROJECT": "your-project" // Azure DevOps 项目名称 (请替换为您的项目名称) } } } }
请注意:
- 请将 'command' 字段中的 '/full/path/to/mcp-azuredevops-bridge/mcp-azuredevops-bridge' 替换为 'mcp-azuredevops-bridge' 可执行文件在您系统中的实际完整路径。
- 'env' 字段中的 'AZURE_DEVOPS_ORG', 'AZDO_PAT', 'AZURE_DEVOPS_PROJECT' 的值需要替换为您在 安装步骤 3 中设置的实际值。
基本使用方法
- 启动 MCP Azure DevOps Bridge 服务器。
- 在 MCP 客户端(如 Windsurf 或 Cursor)中配置并连接到 'azuredevops-bridge' 服务器。
- 使用自然语言指令,通过 MCP 客户端指示 LLM 调用 Azure DevOps 的功能。例如:
- "Create a user story for the new authentication feature in Azure DevOps" (创建用户故事)
- "Get the content of the 'Getting Started' page from the wiki" (获取 Wiki 页面内容)
- "Show me the current sprint's work items and their status" (显示当前 Sprint 的工作项和状态)
- "Add this screenshot as an attachment to work item #123" (为工作项添加附件)
LLM 将根据指令调用 MCP 服务器提供的工具,与 Azure DevOps 进行交互,并返回结果。
信息
分类
开发者工具