Azure DevOps MCP Server

基本能力

产品定位

Azure DevOps MCP Server 是一个用于与 Azure DevOps 服务交互的 MCP 服务器，通过 AI 助手提供高效的工具和操作。

核心功能

1. 基于实体的架构：工具按实体（如项目、仓库、工作项等）组织，每个实体工具提供多个操作（如列表、获取、创建等）。
2. 错误处理：提供分类错误、上下文信息、用户友好消息和故障排除提示。
3. 分页支持：所有列表操作支持基于游标的分页，包括继续令牌和可自定义的页面大小。
4. 配置管理：支持通过环境变量或配置文件进行配置。

适用场景

1. 项目管理：管理 Azure DevOps 中的项目、仓库、工作项和拉取请求。
2. CI/CD 管理：管理 CI/CD 管道和构建。
3. 团队协作：通过 AI 助手高效地与 Azure DevOps 交互，提升团队协作效率。

工具列表

1. Projects Tool：管理 Azure DevOps 项目，支持列表和获取操作。
2. Repositories Tool：管理 Git 仓库，支持列表、获取和分支列表操作。
3. Work Items Tool：管理工作项，支持获取和创建操作。
4. Pull Requests Tool：管理拉取请求，支持列表和获取操作。
5. Pipelines Tool：管理 CI/CD 管道，支持列表和获取操作。

常见问题解答

1. 如何配置服务器？ 可以通过环境变量或配置文件进行配置，具体配置项包括组织名称、项目名称、个人访问令牌等。
2. 如何分页？ 所有列表操作支持基于游标的分页，通过 maxResults 和 continuationToken 参数控制。
3. 如何处理错误？ 服务器提供分类错误和用户友好消息，帮助快速定位和解决问题。

使用教程

使用依赖

1. 确保已安装 Node.js 和 npm。
2. 确保已安装 Docker（如需使用 Docker 运行）。

安装教程

1. 克隆项目仓库。
2. 安装依赖：

npm install

1. 构建项目：

npm run build

1. 运行服务器：

node build/index.js

Docker 安装

1. 构建 Docker 镜像：

docker build -t azure-devops-mcp:local .

1. 运行 Docker 容器：

docker run -i --rm -e ADO_ORGANIZATION=your-org -e ADO_PAT=your-pat azure-devops-mcp:local

调试方式

1. 确保配置正确，包括组织名称和个人访问令牌。
2. 使用示例请求测试服务器功能，例如：

{
  "operation": "list",
  "listParams": {
    "maxResults": 10
  }
}

1. 检查日志和错误消息，确保服务器正常运行。

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。