Azure DevOps MCP 服务器指南

简介

MCP（机器类协议）是一种用于与Azure DevOps服务交互的协议。通过使用此服务器，您能够自动化和管理各种开发任务。

配置项目

身份验证设置

为了连接到Azure DevOps，必须配置身份验证。支持以下方法：

1. 个人访问令牌（PAT）：

   az devops login --organization https://dev.azure.com/your-org --username your-username --password your-pat
   

2. OAuth2.0：

   • 登录Azure DevOps
   • 生成新的访问令牌
   • 使用生成的令牌进行身份验证

连接到Azure DevOps组织

在项目配置文件中指定目标组织：

export const config = {
  organization: 'your-org',
  project: 'your-project',
  // 其他配置...
};

项目结构

项目分为以下几个主要部分：

• src/
  • Interfaces/：定义参数和响应的类型
  • Services/：处理与Azure DevOps API的通信
  • Tools/：提供MCP协议接口的功能实现
  • index.ts：服务器启动入口点
  • config.ts：配置管理

服务层

核心服务类

• WorkItemService：处理工作项操作，如创建、更新和查询。
• GitService：管理代码仓库，包括分支、标签和提交操作。
• BuildService：控制构建过程，监控构建状态。
• ReleaseService：管理发布管道，执行环境配置。

示例代码

// src/Services/WorkItemService.ts
export class WorkItemService {
  private client: WorkItemHttpClient;

  constructor() {
    this.client = new WorkItemHttpClient();
  }

  public async getWorkItems(query: string): Promise<WorkItem[]> {
    return await this.client.queryWorkItems(query);
  }
}

工具层

工具实现

• GitTools：提供代码仓库操作接口，如listRepositories、getBranches等。
• BuildTools：封装构建相关功能，如queueBuild、getBuildStatus等。

配置管理

项目配置存储在config.ts文件中：

export const config = {
  organizationUrl: 'https://dev.azure.com/your-org',
  projectId: 'your-project-id',
  authentication: {
    type: 'pat', // 可选：'oauth2'
    token: 'your-personal-access-token'
  }
};

身份验证流程

1. 初始化身份验证提供程序：

   const authProvider = new AzureAuthProvider(config.authentication);
   

2. 获取访问令牌：

   async function getAccessToken(): Promise<string> {
     return await authProvider.getAccessToken();
   }
   

故障排除

常见问题

1. 认证错误

• 确保个人访问令牌有效且具有正确的权限。
• 检查组织URL是否正确。

2. TypeScript编译错误

• 使用npm run build:ignore-errors跳过类型检查。
• 检查是否有缺失或错误的类型定义。

贡献指南

欢迎贡献！按照以下步骤：

1. ** Fork仓库**
2. ** 创建功能分支**：

   git checkout -b feature/amazing-feature
   

3. ** 提交更改**：

   git add .
   git commit -m "添加新功能"
   

4. ** 推送到GitHub**：

   git push origin feature/amazing-feature
   

许可证

项目遵循MIT许可证，具体见LICENSE文件。

通过以上指南，您可以成功配置和使用Azure DevOps MCP服务器，实现开发流程的自动化管理。