MCP Azure DevOps

Servidor MCP (Model Context Protocol) que conecta Claude con Azure DevOps. Consulta sprints, reportes de tareas, bugs activos y crea tareas en Historias de Usuario — todo en lenguaje natural, sin abrir el navegador.

Demo

Usuario:  "Genera el reporte del Sprint 5 del proyecto Sisdepp"

Claude:   Consultando Azure DevOps...

          Proyecto: Sisdepp  |  Equipo: Sisdepp
          Sprint: Sprint 5  [2025-04-01 → 2025-04-14]
          Total work items: 18
          Story points: 34 completados / 55 totales

          ## Active (6)
            - [Task] #1041 Implementar autenticación JWT | María López | 8 pts | P1
            - [Task] #1044 Revisar modelo de base de datos | Juan García | 5 pts | P2
            ...

          ## Done (12)
            - [User Story] #1020 Login de usuarios | Ana Torres | 13 pts
            ...

          Completitud: 61%

Herramientas disponibles

| Herramienta | Descripción | |---|---| | listar_proyectos | Lista todos los proyectos de la organización | | listar_sprints | Lista los sprints de un proyecto con fechas | | obtener_tareas_sprint | Reporte completo de un sprint: estados, responsables, story points | | obtener_bugs_activos | Bugs no cerrados ordenados por prioridad | | crear_tarea_en_historia | Crea una Task vinculada a una Historia de Usuario existente |

Arquitectura

Claude Code (CLI)
      │
      │  MCP via stdio
      ▼
  server.py  ◄── variables de entorno (org, PAT)
      │
      │  HTTPS + Basic Auth
      ▼
Azure DevOps REST API v7.1

Claude Code lanza server.py como subproceso local. No hay servidor HTTP ni puerto abierto — la comunicación es por stdio, local y directa.

Requisitos

• Python 3.11+
• Claude Code instalado
• Acceso a una organización de Azure DevOps con un PAT generado

Instalación rápida

1. Clonar e instalar dependencias

git clone https://github.com/HarryKill2001/mcp-azuredevops.git
cd mcp-azuredevops

python -m venv .venv
.venv\Scripts\activate        # Windows
# source .venv/bin/activate   # macOS / Linux

pip install fastmcp httpx python-dotenv

2. Configurar credenciales

cp .env.example .env

Editar .env:

AZURE_DEVOPS_ORG=nombre-de-tu-organizacion
AZURE_DEVOPS_TOKEN=tu-personal-access-token

3. Registrar en Claude Code

Editar C:\Users\{usuario}\.claude\settings.json:

{
  "mcpServers": {
    "azuredevops": {
      "command": "C:/ruta/al/proyecto/.venv/Scripts/python.exe",
      "args": ["C:/ruta/al/proyecto/server.py"],
      "env": {
        "AZURE_DEVOPS_ORG": "nombre-de-tu-organizacion",
        "AZURE_DEVOPS_TOKEN": "tu-personal-access-token"
      }
    }
  }
}

4. Verificar

Abrir Claude Code y ejecutar /mcp. El servidor azuredevops debe aparecer como activo.

Para instrucciones detalladas, ver GUIA.md.

Ejemplos de uso

"¿Qué proyectos tenemos en Azure DevOps?"

"¿Qué sprints tiene el proyecto Sisdepp?"

"Muéstrame las tareas del Sprint 3 del proyecto Zeus"

"Genera el reporte completo del Sprint 5 de Inscripciones"

"¿Cuántos bugs activos tiene el proyecto Risicar?"

"Crea una tarea 'Revisar modelo de datos' en la historia #1042,
 responsable 'Juan García', tipo Planned, 4 horas estimadas"

Generar un PAT en Azure DevOps

1. https://dev.azure.com/{org} → tu avatar → Personal access tokens
2. New Token con los siguientes permisos:

| Scope | Permiso | |---|---| | Work Items | Read & Write | | Project and Team | Read |

3. Copiar el token — solo se muestra una vez.

Soporte para plantilla CMMI

Si tu proyecto usa la plantilla de proceso CMMI, la herramienta crear_tarea_en_historia requiere dos campos adicionales obligatorios:

| Campo | API Name | Valores válidos | |---|---|---| | Tipo de tarea | Microsoft.VSTS.CMMI.TaskType | Planned, Corrective Action, Mitigation Action, Regression, Other | | Responsable | Custom.Responsible | Valores del dropdown en tu proyecto |

Stack

| Tecnología | Rol | |---|---| | FastMCP | Framework para servidores MCP | | httpx | Cliente HTTP asíncrono | | python-dotenv | Variables de entorno | | Azure DevOps REST API v7.1 | Fuente de datos |

Documentación completa

Ver GUIA.md para:

• Instalación paso a paso con capturas
• Descripción detallada de cada herramienta
• Flujo técnico completo
• Diagnóstico de errores comunes

Licencia

MIT