基本能力
产品定位
Azure DevOps MCP Server 是一个用于与 Azure DevOps 服务交互的 MCP 服务器,通过 AI 助手提供高效的工具和操作。
核心功能
- 基于实体的架构:工具按实体(如项目、仓库、工作项等)组织,每个实体工具提供多个操作(如列表、获取、创建等)。
- 错误处理:提供分类错误、上下文信息、用户友好消息和故障排除提示。
- 分页支持:所有列表操作支持基于游标的分页,包括继续令牌和可自定义的页面大小。
- 配置管理:支持通过环境变量或配置文件进行配置。
适用场景
- 项目管理:管理 Azure DevOps 中的项目、仓库、工作项和拉取请求。
- CI/CD 管理:管理 CI/CD 管道和构建。
- 团队协作:通过 AI 助手高效地与 Azure DevOps 交互,提升团队协作效率。
工具列表
- Projects Tool:管理 Azure DevOps 项目,支持列表和获取操作。
- Repositories Tool:管理 Git 仓库,支持列表、获取和分支列表操作。
- Work Items Tool:管理工作项,支持获取和创建操作。
- Pull Requests Tool:管理拉取请求,支持列表和获取操作。
- Pipelines Tool:管理 CI/CD 管道,支持列表和获取操作。
常见问题解答
- 如何配置服务器? 可以通过环境变量或配置文件进行配置,具体配置项包括组织名称、项目名称、个人访问令牌等。
- 如何分页? 所有列表操作支持基于游标的分页,通过
maxResults
和continuationToken
参数控制。 - 如何处理错误? 服务器提供分类错误和用户友好消息,帮助快速定位和解决问题。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm。
- 确保已安装 Docker(如需使用 Docker 运行)。
安装教程
- 克隆项目仓库。
- 安装依赖:
bash
npm install - 构建项目:
bash
npm run build - 运行服务器:
bash
node build/index.js
Docker 安装
- 构建 Docker 镜像:
bash
docker build -t azure-devops-mcp:local . - 运行 Docker 容器:
bash
docker run -i --rm -e ADO_ORGANIZATION=your-org -e ADO_PAT=your-pat azure-devops-mcp:local
调试方式
- 确保配置正确,包括组织名称和个人访问令牌。
- 使用示例请求测试服务器功能,例如:
json
{
"operation": "list",
"listParams": {
"maxResults": 10
}
} - 检查日志和错误消息,确保服务器正常运行。