项目简介

这个项目是一个基于Model Context Protocol (MCP) 构建的服务器，旨在让大语言模型（LLM）或其他AI客户端能够方便地访问和操作Azure DevOps中的数据和功能。它将Azure DevOps的各种操作封装成标准的MCP工具，供LLM调用。

主要功能点

工作项管理: 支持列出、获取详细信息以及创建新的Azure DevOps工作项（如任务、错误等）。
拉取请求操作: 提供列出、获取详细信息、创建拉取请求，以及为拉取请求添加评论和获取差异（Diff）的能力。
Wiki页面管理: 允许创建和编辑Azure DevOps Wiki中的页面。
项目信息: 可以列出或获取特定Azure DevOps项目的详细信息。

安装步骤

确保您的系统已安装 Node.js 和 npm。
从GitHub仓库 ('https://github.com/mmruesch12/azdo-mcp') 下载或克隆项目代码到本地目录。
在项目根目录下打开终端，运行 'npm install' 命令安装所需的项目依赖。

在项目根目录下创建一个名为 '.env' 的文件，用于配置服务器连接Azure DevOps所需的环境变量。至少需要包含以下信息（请替换示例值）：

AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-org
AZURE_DEVOPS_PAT=your-personal-access-token
AZURE_DEVOPS_PROJECT=default-project # 可选，但推荐设置默认项目
AZURE_DEVOPS_REPOSITORY=default-repo # 可选，但推荐设置默认仓库

其中 'AZURE_DEVOPS_PAT' 是您在Azure DevOps中生成的个人访问令牌，需要具备访问您指定项目和仓库的相应权限。

运行 'npm run build' 命令构建服务器代码。构建成功后，可在 'build' 目录下找到可执行文件。

服务器配置

本MCP服务器通过标准输入输出 (Stdio) 方式与兼容的MCP客户端通信。要让MCP客户端（如支持MCP的IDE扩展或AI应用）连接到此服务器，您需要在客户端的MCP设置中添加服务器配置。配置通常是一个JSON对象，包含以下关键信息：

'server name': 用于在客户端中标识此服务器的唯一名称，例如 '"azure-devops"'。
'command': 启动服务器的可执行程序。对于此项目，通常设置为 '"node"'。
'args': 传递给 'command' 的参数列表。此列表应包含构建后服务器入口文件的路径，例如 '["/path/to/azdo-mcp/build/index.js"]' (macOS/Linux) 或 '["C:/path/to/azdo-mcp/build/index.js"]' (Windows)。请确保路径正确指向您本地的项目构建目录。
'env': 一个JSON对象，包含服务器运行时需要的环境变量，特别是您在 '.env' 文件中设置的 Azure DevOps 连接信息（如 'AZURE_DEVOPS_ORG_URL', 'AZURE_DEVOPS_PAT', 'AZURE_DEVOPS_PROJECT', 'AZURE_DEVOPS_REPOSITORY'）。这些环境变量必须在此处传递给服务器进程。
'disabled': 一个布尔值，用于控制服务器是否启用，通常设置为 'false'。

请参考您的MCP客户端文档，将上述信息填入相应的服务器配置部分。

基本使用方法

一旦服务器被MCP客户端成功配置和启动，它就会向客户端声明其提供的工具能力（如列出工作项、创建PR等）。LLM客户端可以通过标准的MCP协议调用这些工具，并传递必要的参数（例如工作项ID、PR标题、分支名称等）。服务器会执行对应的操作（如调用Azure DevOps API），并将结果返回给LLM客户端，LLM便可以根据返回的信息进行后续交互或展示。具体如何通过LLM调用这些工具取决于您使用的MCP客户端应用。

关键词

信息