金大哥 - azdo-mcp MCP 详情

article

README

🚀 Azure DevOps MCP 服务器

Azure DevOps MCP 服务器提供与 Azure DevOps 的集成能力，借助 MCP（模型上下文协议），它能让 AI 助手与 Azure DevOps 的工作项、拉取请求以及 wiki 页面进行交互，极大提升工作效率。

🚀 快速开始

本服务器可实现与 Azure DevOps 的集成，让 AI 助手轻松与工作项、拉取请求和 wiki 页面交互。以下为您详细介绍使用步骤。

✨ 主要特性

🔧 工作项管理：支持创建、列出和获取工作项。
📑 拉取请求操作：可进行创建、列出、获取、评论和查看差异等操作。
📚 维基页面管理：支持创建和编辑维基页面。

📦 安装指南

安装准备

安装依赖：

npm install

配置环境变量（创建一个 .env 文件）：

AZURE_DEVOPS_ORG_URL=https://dev.azure.com/your-org
AZURE_DEVOPS_PAT=你的个人访问令牌
AZURE_DEVOPS_PROJECT=default-project
AZURE_DEVOPS_REPOSITORY=default-repo

构建服务器：

npm run build

正式安装

将服务器配置添加到您的 MCP 设置中：

对于 VSCode

在 macOS/Linux 上：将以下内容添加到 ~/.vscode/cline_mcp_settings.json 或类似文件：

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["/path/to/azure-devops-mcp/build/index.js"],
      "devMode": false
    }
  }
}

在 Windows 上：将以下内容添加到 C:\\Users\\<YourUsername>\\.vscode\\cline_mcp_settings.json：

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["C:\\path\\to\\azure-devops-mcp\\build\\index.js"],
      "devMode": false
    }
  }
}

💻 使用示例

工作项

基础用法 - 创建工作项

POST /workitems
Content-Type: application/json

{
  "title": "新任务",
  "description": "这是一个新的 Azure DevOps 工作项。",
  "project": "default-project",
  "type": "task"
}

高级用法 - 获取工作项

获取所有工作项：

GET /workitems

获取特定工作项：

GET /workitems/{id}

拉取请求

基础用法 - 创建拉取请求

POST /pullrequests
Content-Type: application/json

{
  "sourceBranch": "refs/heads/main",
  "targetBranch": "refs/heads/master",
  "title": "新的功能提交"
}

高级用法 - 获取拉取请求

获取所有拉取请求：

GET /pullrequests

获取特定拉取请求：

GET /pullrequests/{id}

维基

基础用法 - 创建维基页面

POST /wiki/defaultwiki/_/newfile
Content-Type: application/json

{
  "path": "/pages/home.md",
  "content": "## 欢迎来到我们的新维基！"
}

高级用法 - 更新维基页面

PUT /wiki/defaultwiki/_/file/pages/home.md
Content-Type: application/json

{
  "content": "## 欢迎来到更新的维基！",
  "etag": "12345678-90AB-CDEF-1234-567890ABCDEF"
}

🔧 技术细节

在开发模式下运行，并使用环境变量：

npm run dev

⚠️ 重要提示

除非工具参数中明确指定了 project 和 repository，否则将使用从您的环境配置中指定的默认值。

azdo-mcp