使用说明
项目简介
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 服务器的传输协议,易于集成和部署,适用于本地开发和服务器环境。
安装步骤
- 克隆仓库: 将 GitHub 仓库 'https://github.com/dpk83/adomcpserver' 克隆到本地。
- 安装依赖: 在项目根目录下,打开终端并运行命令 'npm install' 安装项目依赖。
- 配置环境变量: 在项目根目录下创建 '.env' 文件,并根据你的 Azure DevOps 环境配置以下环境变量:
请确保你的个人访问令牌 (PAT) 具有访问 Azure DevOps REST API 的权限。AZURE_DEVOPS_ORG=你的AzureDevOps组织名称 AZURE_DEVOPS_PROJECT=你的AzureDevOps项目名称 AZURE_DEVOPS_PAT=你的AzureDevOps个人访问令牌
服务器配置
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 服务器。
基本使用方法
- 启动 MCP 服务器: 在项目根目录下,打开终端并运行命令 'npm start' 启动 MCP 服务器。服务器将通过 Stdio 协议等待客户端连接。
- 配置 MCP 客户端: 在 MCP 客户端中,配置上述 服务器配置 信息,确保客户端能够连接到正在运行的 ADO Work Items Tracker MCP Server。
- 调用工具: 在 LLM 应用或 MCP 客户端中,可以调用名为 'ADO_WorkItem_GetAndUpdate_Tool' 的工具,并根据工具的 Schema 提供相应的参数(例如 'path', 'method', 'queryParams', 'body', 'contentType')来与 Azure DevOps 进行交互。例如,可以查询指定 ID 的工作项详情,或者创建一个新的 Bug。
- 查看结果: 工具执行结果将以 JSON 格式返回给 MCP 客户端,客户端可以解析并展示 Azure DevOps API 的响应信息。
信息
分类
开发者工具