Arcade Azure Devops MCP

街机蔚蓝devops mcp

用于Azure DevOps的MCP服务器 Arcade.dev。使AI助手能够与Azure DevOps项目、工作项、存储库、管道、wiki等进行交互。

特性

21工具 涵盖：

• 核心：列出项目、团队、搜索身份
• 工作项：获取、创建、更新、查询工作项；添加注释
• 仓库：列出仓库、分支、拉取请求；创建PR
• 管道：列出定义、版本；队列构建；运行管道
• 维基：列出wiki，获取wiki页面
• 搜索：跨存储库搜索代码

快速开始

1.安装依赖项

uv sync

2.配置凭据

提供Azure DevOps凭据有两种选择：

选项A：环境变量(.env 文件）

复制示例环境文件并添加您的凭据：

cp .env.example .env

编辑 .env:

AZURE_DEVOPS_ORG=your-organization-name
AZURE_DEVOPS_PAT=your-personal-access-token

选项B：街机秘密（建议用于制作）

如果没有 .env 如果找到文件或环境变量，服务器会自动回退到 街机秘密这非常适合：

• 向Arcade市场发布
• 共享工具包而不暴露凭据
• 通过Arcade Deploy进行生产部署

在Arcade中配置机密：

# Login to Arcade
arcade login

# Set your secrets
arcade secrets set AZURE_DEVOPS_ORG "your-organization-name"
arcade secrets set AZURE_DEVOPS_PAT "your-personal-access-token"

或通过配置 街机仪表板.

它是如何工作的：

1. 服务器首先检查环境变量
2. 如果未找到，请通过以下方式向Arcade Cloud请求机密 context.get_secret()
3. Arcade提示用户授权秘密访问（仅限第一次）

3.创建个人访问令牌（PAT）

1. 首选 https://dev.azure.com/{your-org}/_usersSettings/tokens
2. 点击“新建令牌”
3. 选择范围：代码（读取/写入）、工作项（读取/写）、构建（读取/执行）、Wiki（读取/编写）
4. 复制令牌

4.运行MCP服务器

# stdio transport (default) - for Claude Desktop, CLI tools
uv run server.py stdio

# http transport - for Cursor, VS Code
uv run server.py http

对于HTTP传输，请在上查看API文档http://127.0.0.1:8000/docs

配置MCP客户端

光标IDE

arcade configure cursor

或手动添加到 .cursor/mcp.json:

对于环境变量：

{
  "mcpServers": {
    "azure-devops": {
      "command": "uv",
      "args": ["run", "server.py", "stdio"],
      "cwd": "/path/to/arcade-azure-devops-mcp",
      "env": {
        "AZURE_DEVOPS_ORG": "your-org",
        "AZURE_DEVOPS_PAT": "your-pat"
      }
    }
  }
}

使用Arcade Secrets（无本地凭据）：

{
  "mcpServers": {
    "azure-devops": {
      "command": "uv",
      "args": ["run", "server.py", "stdio"],
      "cwd": "/path/to/arcade-azure-devops-mcp"
    }
  }
}

VS Code

arcade configure vscode

克劳德桌面

arcade configure claude

可用工具

建筑

请求流

┌────────────┐      ┌────────────┐      ┌──────────────┐      ┌─────────────┐
│ MCP Client │      │ MCP Server │      │ Arcade Cloud │      │ Azure DevOps│
└─────┬──────┘      └─────┬──────┘      └──────┬───────┘      └──────┬──────┘
      │                   │                    │                     │
      │  Call tool        │                    │                     │
      │──────────────────>│                    │                     │
      │                   │                    │                     │
      │                   │ Check env vars     │                     │
      │                   │◄──────────────────►│                     │
      │                   │                    │                     │
      │                   │ [If env vars missing - paid tier]        │
      │                   │ get_secret()       │                     │
      │                   │───────────────────>│                     │
      │                   ││
      │                   │
View Mermaid diagram (for GitHub/GitLab)

sequenceDiagram participant C as MCP Client participant S as MCP Server participant A as Arcade Cloud participant D as Azure DevOps

C->>S: Call tool (e.g., list_projects)

Note over S: Resolve Credentials S->>S: Check env: AZURE_DEVOPS_ORG S->>S: Check env: AZURE_DEVOPS_PAT

alt Environment variables exist S->>S: Use local credentials else Environment variables missing (paid tier) S->>A: context.get_secret("AZURE_DEVOPS_ORG") A-->>S: Return organization name S->>A: context.get_secret("AZURE_DEVOPS_PAT") A-->>S: Return PAT token end

Note over S,D: API Request S->>D: GET /{org}/_apis/projects?api-version=7.1 D-->>S: JSON response

S-->>C: Tool result

### 组件概述

┌─────────────────────────────────────────────────────────────────────────────┐ │ MCP CLIENT │ │ (Cursor / Claude Desktop) │ └─────────────────────────────────┬───────────────────────────────────────────┘ │ MCP Protocol (stdio/http) ▼ ┌─────────────────────────────────────────────────────────────────────────────┐ │ MCP SERVER │ │ ┌─────────────────┐ ┌──────────────────┐ ┌─────────────────────────┐ │ │ │ MCPApp │ │ Azure DevOps │ │ AuthManager │ │ │ │ Framework │──│ Tools (21) │──│ (credential resolver) │ │ │ └─────────────────┘ └──────────────────┘ └───────────┬─────────────┘ │ └─────────────────────────────────────────────────────────┼───────────────────┘ │ ┌─────────────────────────────────┼─────────────────┐ │ │ │ ▼ [Priority 1] ▼ [Priority 2] │ ┌─────────────────────────┐ ┌───────────────────────┐ │ │ Local .env / │ │ Arcade Cloud │ │ │ Environment Variables │ │ (Secrets API) │ │ └─────────────────────────┘ │ [Paid tier only] │ │ └───────────────────────┘ │ │ ┌─────────────────┘ ▼ ┌───────────────────────┐ │ Azure DevOps │ │ REST API v7.1 │ └───────────────────────┘

View Mermaid diagram (for GitHub/GitLab)

flowchart TB subgraph MCPClient [MCP Client] Cursor[Cursor / Claude Desktop] end

subgraph MCPServer [MCP Server] App[MCPApp Framework] Tools[Azure DevOps Tools] Auth[AuthManager] end

subgraph External [External Services] Arcade[Arcade Cloud - Secrets API] ADO[Azure DevOps REST API v7.1] end

subgraph Local [Local Config] Env[.env file / Environment Variables] end

Cursor -->|MCP Protocol| App App --> Tools Tools --> Auth Auth -->|Priority 1| Env Auth -.->|Priority 2 - Paid Tier| Arcade Auth -->|Basic Auth| ADO

### 凭证解析优先级

1. **环境变量** (`.env` 文件或系统环境）-先检查
1. **Arcade Cloud的秘密** -如果找不到env变量，则回退（需要付费Arcade层）

## 项目结构

arcade-azure-devops-mcp/ ├── server.py # MCP server entry point with all tools ├── arcade_azure_devops_mcp/ # Azure DevOps client library │ ├── __init__.py │ ├── client.py # REST API client (httpx) │ ├── models.py # Pydantic models │ └── auth/ # Authentication │ ├── __init__.py │ ├── manager.py # Credential management (env + Arcade secrets) │ └── oauth.py # OAuth/Azure AD (optional) ├── pyproject.toml # Dependencies & entry points ├── .env.example # Environment template └── README.md

## 发展

Install with dev dependencies

uv sync --all-extras

Run tests

uv run pytest

## 发布到Arcade

要将此工具包发布到Arcade市场：

Ensure pyproject.toml has correct entry points

arcade publish

然后，用户可以通过以下方式安装：

arcade install arcade-azure-devops-mcp

## 许可证

麻省理工学院

## 链接

- [Arcade.dev文档](https://docs.arcade.dev)
- [Azure DevOps REST API](https://docs.microsoft.com/en-us/rest/api/azure/devops)
- [MCP规范](https://modelcontextprotocol.io)