mcp-azure-devops

Un servidor de Model Context Protocol para Azure DevOps. Permite que un cliente compatible con MCP (Claude Desktop, Claude Code, Cursor, Codex, …) trabaje con boards, repos, pipelines y proyectos, con una capa de gobernanza que mantiene a un agente de IA dentro de límites seguros.

Qué ofrece

• Proyectos y equipos — enumerar proyectos/equipos/miembros, inspeccionar plantillas de proceso.

• Boards / elementos de trabajo — consultas WIQL, obtener elementos de trabajo, crear/actualizar elementos de trabajo, listar iteraciones (sprints).

• Repos / pull requests — listar repositorios y ramas, listar/obtener pull requests, abrir pull requests.

• Pipelines / builds — listar pipelines y builds recientes, obtener un build, poner en cola una ejecución.

• Admin / proceso — listar plantillas de proceso, crear un proyecto, eliminar un proyecto (protegido).

• Gobernanza integrada — modos de acceso, listas de proyectos permitidas, proyectos protegidos, restricción de borrado, confirmación tipada para operaciones de alto impacto, dry-run y registro de auditoría JSON.

Related MCP server: Azure DevOps MCP Server

Modelo de gobernanza y seguridad

Herramientas

Lectura (read-only+): list_projects, get_project, list_teams, list_team_members, list_processes, query_work_items, get_work_item, list_iterations, list_repositories, list_branches, list_pull_requests, get_pull_request, list_pipelines, list_builds, get_build

Escritura (read-write+): create_work_item, update_work_item, create_pull_request, run_pipeline

Admin (admin): create_project, delete_project (requiere AZDO_ALLOW_DELETE + confirm tipado)

Inicio rápido — añádelo a tu agente

Publicado en npm como @dockndevai/mcp-azure-devops. Se ejecuta con npx; necesita una organización y un PAT. Consulta docs/CLIENTS.md para todos los clientes y .env.example para todas las variables.

Claude Code

claude mcp add azure-devops -e AZDO_ORG_URL="https://dev.azure.com/your-org" -e AZDO_PAT="your-pat" -e AZDO_MODE="read-only" -- npx -y @dockndevai/mcp-azure-devops

Claude Desktop · Cursor · Windsurf

{
  "mcpServers": {
    "azure-devops": {
      "command": "npx",
      "args": ["-y", "@dockndevai/mcp-azure-devops"],
      "env": {
        "AZDO_ORG_URL": "https://dev.azure.com/your-org",
        "AZDO_PAT": "your-pat",
        "AZDO_MODE": "read-only"
      }
    }
  }
}

Prompts de ejemplo

• "Lista las pull requests activas del repositorio api del proyecto Payments"

• "Consulta los elementos de trabajo asignados a mí que sigan en estado Active"

• "Muestra los últimos 10 builds del proyecto Web y cuáles fallaron"

• "Crea un Bug en Payments titulado 'Error 500 al reintentar el checkout'" (requiere read-write)

Ejecutar desde el código fuente (desarrollo)

npm install
npm run build
node dist/index.js   # with the environment variables set

Desarrollo

npm run dev
npm test          # governance policy: modes, allowlists, delete gating, confirmation
npm run typecheck

Publicación

Incluye un server.json para el registro oficial de MCP y un mcpName para validar la propiedad en npm. Consulta PUBLISHING.md.

Licencia

MIT