使用说明

项目简介

Tizzani.AzureDevOps.MCP 是一个基于 Model Context Protocol (MCP) 的服务器实现，旨在将 Azure DevOps 的功能以标准化的方式提供给 LLM 客户端。通过此服务器，LLM 应用可以安全、可扩展地访问 Azure DevOps 中的工作项、Git 仓库、拉取请求等信息，从而实现更智能的 DevOps 自动化和集成。

主要功能点

工作项管理工具: 提供多种工具用于查询和操作 Azure DevOps 工作项，包括获取工作项类型、状态、字段、评论以及执行 WIQL 查询等。
Git 仓库工具: 提供工具用于访问 Azure DevOps Git 仓库信息，包括列出仓库、获取文件内容 (Blob)、获取提交信息、差异 (Diffs)、拉取请求 (Pull Requests) 及其相关迭代和线程等。
基于标准 MCP 协议: 遵循 MCP 协议规范，易于与任何兼容 MCP 协议的 LLM 客户端集成。
可扩展的工具集: 工具以插件形式组织，方便扩展和添加新的 Azure DevOps 功能支持。
使用 Stdio 传输协议: 通过标准输入输出流与 MCP 客户端通信，配置简单。

安装步骤

安装 .NET SDK: 确保您的系统已安装 .NET SDK (建议最新版本)。

安装工具: 通过 .NET 工具命令全局安装 'Tizzani.AzureDevOps.MCP'：

dotnet tool install --global Tizzani.AzureDevOps.MCP --prerelease

安装成功后，您应该可以在命令行中运行 'tizzani.adomcp' 命令。

服务器配置

要让 MCP 客户端连接到 Azure DevOps MCP Server，您需要在客户端的 MCP 服务器配置中添加以下 JSON 配置。请根据您的 Azure DevOps 环境修改相应的参数。

"mcpServers": {
  "azuredevops": {  //  服务器名称，可以自定义
    "command": "tizzani.adomcp",  //  服务器启动命令，安装工具后为 tizzani.adomcp
    "args": [
      "--ado_token=YOUR_AZURE_DEVOPS_PERSONAL_ACCESS_TOKEN",  //  您的 Azure DevOps Personal Access Token，需要有访问项目权限
      "--ado_organization=YOUR_AZURE_DEVOPS_ORGANIZATION",   //  您的 Azure DevOps 组织名称
      "--ado_project=YOUR_AZURE_DEVOPS_PROJECT"      //  您的 Azure DevOps 项目名称
    ]
  }
}

参数说明:

'ado_token': Azure DevOps Personal Access Token (PAT)。您需要在 Azure DevOps 中生成 PAT，并赋予其访问项目所需的权限（例如，读取工作项、代码等）。
'ado_organization': 您的 Azure DevOps 组织名称。可以在 Azure DevOps 组织的 URL 中找到，例如 'dev.azure.com/{YOUR_AZURE_DEVOPS_ORGANIZATION}'。
'ado_project': 您的 Azure DevOps 项目名称。

基本使用方法

配置 MCP 客户端: 将上述 JSON 配置添加到您的 MCP 客户端配置中，确保客户端能够识别并连接到 'azuredevops' 这个 MCP 服务器。
启动 MCP 客户端: 启动您的 MCP 客户端应用程序。客户端会根据配置启动 'Tizzani.AzureDevOps.MCP' 服务器。
通过 LLM 调用工具: 在 LLM 应用中，您可以使用 MCP 客户端提供的接口，调用 Azure DevOps MCP 服务器提供的工具。例如，调用 'getWorkItems' 工具查询工作项，或调用 'getPullRequests' 工具获取拉取请求信息。

注意: 首次运行或配置变更后，可能需要重启 MCP 客户端才能使配置生效。请参考您的 MCP 客户端文档了解更详细的使用方法。

关键词