Azure Pipelines 辅助服务器

一个为Azure Pipelines提供AI辅助的Model Context Protocol服务器,支持验证YAML、搜索任务、参考文档和检查Git仓库。

  • by sparx2206
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 sparx2206/azure-pipelines-mcp

使用说明

Azure管道MCP服务器

A. 模型上下文协议(MCP) 服务器,为AI助手提供深入的知识和能力 Azure管道.

此服务器使LLM(如Claude、Gemini等)能够:

  • 验证 针对Azure DevOps API的管道YAML。
  • 搜索 对于可用任务及其模式。
  • 参考 表达式、预定义变量和YAML结构。
  • 检查 Azure DevOps项目中的Git存储库。

特性

  • 🔍 任务搜索和参考:查找任务名称、输入和文档(例如,“我如何使用DotNetCoreCLI@2?").
  • ✅ 管道验证:使用官方Azure DevOps Pipeline Preview API验证您的YAML内容(检测语法错误、无效关键字等)。
  • 📚 文档访问:即时访问Azure管道表达式、变量和架构定义。
  • 📂 存储库上下文:列出可用的存储库,以帮助创建上下文感知的管道。

安装

使用 npx (推荐)

您可以直接使用以下命令运行服务器 npx:

npx azure-pipelines-mcp

来源

git clone https://github.com/sparx2206/azure-pipelines-mcp.git
cd azure-pipelines-mcp
npm install
npm run build
node dist/index.js

配置

要使用验证功能和存储库检查,您必须提供Azure DevOps凭据。这些可以设置为环境变量。

变量 描述 必填项?
AZURE_DEVOPS_ORG 您的组织名称(例如。, https://dev.azure.com/{org}). ✅ 是的
AZURE_DEVOPS_PAT 个人访问令牌 构建(读取并执行) 和 代码(读取) 范围。 ✅ 是的
AZURE_DEVOPS_PROJECT 默认项目名称。 ❌ 可选

克劳德桌面版

将以下内容添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "azure-pipelines": {
      "command": "npx",
      "args": ["-y", "azure-pipelines-mcp"],
      "env": {
        "AZURE_DEVOPS_ORG": "my-org",
        "AZURE_DEVOPS_PAT": "my-pat-token",
        "AZURE_DEVOPS_PROJECT": "my-project"
      }
    }
  }
}

VS代码(带MCP扩展)

如果您在VS Code中使用MCP扩展,请在 .vscode/settings.json 或特定于扩展的配置:

{
  "mcp.servers": {
    "azure-pipelines": {
      "command": "npx",
      "args": ["-y", "azure-pipelines-mcp"],
      "env": {
        "AZURE_DEVOPS_ORG": "...",
        "AZURE_DEVOPS_PAT": "..."
      }
    }
  }
}

可用工具

工具 说明
validate_pipeline_yaml 使用Azure DevOps API验证YAML内容。
search_pipeline_tasks 搜索管道任务(例如“docker”)。
get_task_reference 获取特定任务的详细架构/输入。
get_expressions_reference YAML表达式(函数、语法)的文档。
get_predefined_variables 系统变量列表(Build.BuildId等等)。
get_yaml_schema YAML结构参考(steps, stages, pool).
get_repositories 列出项目中的Git存储库。
get_dummy_pipeline 查找验证上下文管道的实用程序。
create_dummy_pipeline 为验证上下文创建管道的实用程序。

验证和虚拟管道

这 validate_pipeline_yaml 该工具使用官方Azure DevOps“管道预览”API。此API需要 现有管道 正确解析变量组、环境和存储库资源。

为了实现这一点,MCP服务器可能需要在您的项目中创建一个占位符管道:

  1. 姓名: DummyValidationPipeline
  2. 文件夹: \AI\ (保持其有序性,并与实际管道分开)
  3. 目的: 它充当“预览”API调用的目标。它是 从未被处决 通过MCP服务器。
  4. 创造: 这 create_dummy_pipeline 该工具创建指向的管道 azure-pipelines.yml 在默认存储库中。

注: 如果删除此管道,验证工具可能会提示重新创建它。

发展

设置

npm install

测试

# Run unit tests
npm test

# Watch mode
npm run test:watch

更新数据

服务器使用嵌入式数据集来提高速度。要从Microsoft文档中更新它们,请执行以下操作:

npm run update-data

许可证

麻省理工学院