使用说明

项目简介

ADO Work Items Tracker MCP Server 是一个基于 Model Context Protocol (MCP) 构建的服务器,旨在通过工具的方式,让 LLM 应用能够与 Azure DevOps 进行交互,实现工作项的查询、创建、更新和删除等操作。

主要功能点

  • Azure DevOps 工作项管理工具: 提供一个名为 'ADO_WorkItem_GetAndUpdate_Tool' 的工具,允许 LLM 客户端通过 Azure DevOps REST API 获取和操作工作项,例如查询、创建、更新和删除 Bug、任务等。
  • REST API 交互: 支持多种 HTTP 方法 (GET, POST, PUT, PATCH, DELETE) 操作 Azure DevOps API,可以灵活地与 Azure DevOps 进行数据交互。
  • 环境变量配置: 通过环境变量 'AZURE_DEVOPS_ORG', 'AZURE_DEVOPS_PROJECT', 'AZURE_DEVOPS_PAT' 进行 Azure DevOps 的组织、项目和个人访问令牌 (PAT) 的配置,方便部署和管理。
  • Stdio 传输协议: 使用 Stdio 作为 MCP 服务器的传输协议,易于集成和部署,适用于本地开发和服务器环境。

安装步骤

  1. 克隆仓库: 将 GitHub 仓库 'https://github.com/dpk83/adomcpserver' 克隆到本地。
  2. 安装依赖: 在项目根目录下,打开终端并运行命令 'npm install' 安装项目依赖。
  3. 配置环境变量: 在项目根目录下创建 '.env' 文件,并根据你的 Azure DevOps 环境配置以下环境变量:
    AZURE_DEVOPS_ORG=你的AzureDevOps组织名称
    AZURE_DEVOPS_PROJECT=你的AzureDevOps项目名称
    AZURE_DEVOPS_PAT=你的AzureDevOps个人访问令牌
    请确保你的个人访问令牌 (PAT) 具有访问 Azure DevOps REST API 的权限。

服务器配置

MCP 客户端需要配置以下信息以连接到 ADO Work Items Tracker MCP Server。以下配置为 JSON 格式,请复制到 MCP 客户端的服务器配置中。

{
  "serverName": "ado-workitems-tracker",
  "command": "npm",
  "args": ["start"]
}
  • 'serverName': 服务器名称,必须与 MCP 服务器代码中定义的名称 '"ado-workitems-tracker"' 一致。
  • 'command': 启动服务器的命令,这里使用 'npm' 命令。
  • 'args': 传递给 'npm' 命令的参数,'start' 参数会执行 'package.json' 中定义的 'start' 脚本,从而启动 MCP 服务器。

基本使用方法

  1. 启动 MCP 服务器: 在项目根目录下,打开终端并运行命令 'npm start' 启动 MCP 服务器。服务器将通过 Stdio 协议等待客户端连接。
  2. 配置 MCP 客户端: 在 MCP 客户端中,配置上述 服务器配置 信息,确保客户端能够连接到正在运行的 ADO Work Items Tracker MCP Server。
  3. 调用工具: 在 LLM 应用或 MCP 客户端中,可以调用名为 'ADO_WorkItem_GetAndUpdate_Tool' 的工具,并根据工具的 Schema 提供相应的参数(例如 'path', 'method', 'queryParams', 'body', 'contentType')来与 Azure DevOps 进行交互。例如,可以查询指定 ID 的工作项详情,或者创建一个新的 Bug。
  4. 查看结果: 工具执行结果将以 JSON 格式返回给 MCP 客户端,客户端可以解析并展示 Azure DevOps API 的响应信息。

信息

分类

开发者工具