MCP Azure DevOps Server

by Vortiago
Verified

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

  • Enables repository operations for Azure DevOps Git repositories, supporting features like pull request management (planned).

  • Allows installation of the MCP server package from PyPI, making deployment easier through standard Python package management.

  • Built using Python SDK for MCP implementation, requiring Python 3.9+ for server installation and operation.

Servidor MCP de Azure DevOps

Un servidor de Protocolo de contexto de modelo (MCP) que permite que los asistentes de IA interactúen con los servicios de Azure DevOps.

Descripción general

Este proyecto implementa un servidor de Protocolo de contexto de modelo (MCP) que permite a los asistentes de IA (como Claude) interactuar con Azure DevOps, proporcionando un puente entre las interacciones de lenguaje natural y la API REST de Azure DevOps.

Características

Implementado actualmente:

Gestión de elementos de trabajo

  • Consulta de elementos de trabajo : busque elementos de trabajo mediante consultas WIQL
  • Obtener detalles del elemento de trabajo : ver información completa del elemento de trabajo
  • Crear elementos de trabajo : agregue nuevas tareas, errores, historias de usuario y otros tipos de elementos de trabajo
  • Actualizar elementos de trabajo : modificar los campos y propiedades de los elementos de trabajo existentes
  • Agregar comentarios : Publicar comentarios sobre elementos de trabajo
  • Ver comentarios : recuperar el historial de comentarios de un elemento de trabajo
  • Relaciones padre-hijo : establecer jerarquía entre elementos de trabajo

Gestión de proyectos

  • Obtener proyectos : ver todos los proyectos accesibles en la organización
  • Obtener equipos : enumera todos los equipos dentro de la organización
  • Miembros del equipo : ver información de membresía del equipo
  • Rutas de área del equipo : recupera las rutas de área asignadas a los equipos
  • Iteraciones del equipo : acceder a las configuraciones de iteración/sprint del equipo

Características planificadas:

  • Operaciones de canalización : consulta el estado de la canalización y activa nuevas ejecuciones de canalización
  • Manejo de solicitudes de extracción : crear, actualizar y revisar solicitudes de extracción
  • Gestión de sprints : planificar y gestionar sprints e iteraciones
  • Administración de políticas de sucursales : configurar y administrar políticas de sucursales

Empezando

Prerrequisitos

  • Python 3.10+
  • Cuenta de Azure DevOps con los permisos adecuados
  • Token de acceso personal (PAT) con los alcances necesarios para el acceso a la API de Azure DevOps

Instalación

# Clone the repository git clone https://github.com/Vortiago/mcp-azure-devops.git cd mcp-azure-devops # Install in development mode uv pip install -e ".[dev]" # Install from PyPi pip install mcp-azure-devops

Configuración

Cree un archivo .env en la raíz del proyecto con las siguientes variables:

AZURE_DEVOPS_PAT=your_personal_access_token AZURE_DEVOPS_ORGANIZATION_URL=https://your-organization.visualstudio.com or https://dev.azure.com/your-organisation

Nota: asegúrese de proporcionar la URL completa a su organización de Azure DevOps.

Ejecución del servidor

# Development mode with the MCP Inspector mcp dev src/mcp_azure_devops/server.py # Install in Claude Desktop mcp install src/mcp_azure_devops/server.py --name "Azure DevOps Assistant"

Ejemplos de uso

Elementos de trabajo de consulta

Show me all active bugs assigned to me in the current sprint

Crear un elemento de trabajo

Create a user story in the ProjectX with the title "Implement user authentication" and assign it to john.doe@example.com

Actualizar un elemento de trabajo

Change the status of bug #1234 to "Resolved" and add a comment explaining the fix

Gestión de equipos

Show me all the team members in the "Core Development" team in the "ProjectX" project

Ver la estructura del proyecto

List all projects in my organization and show me the iterations for the Development team

Desarrollo

El proyecto está estructurado en módulos de funciones, cada uno de los cuales implementa capacidades específicas de Azure DevOps:

  • features/work_items : Funcionalidad de gestión de elementos de trabajo
  • features/projects : Capacidades de gestión de proyectos
  • features/teams : Funciones de gestión de equipos
  • utils : utilidades comunes e inicialización del cliente

Para obtener más información sobre el desarrollo, consulte el archivo CLAUDE.md .

Contribuyendo

¡Agradecemos sus contribuciones! No dude en enviar una solicitud de incorporación de cambios.

Licencia

Este proyecto está licenciado bajo la licencia MIT: consulte el archivo de LICENCIA para obtener más detalles.

Expresiones de gratitud

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

Un servidor de protocolo de contexto de modelo que permite a los asistentes de IA interactuar con los servicios de Azure DevOps, lo que permite a los usuarios consultar elementos de trabajo con planes para respaldar la creación y actualización de elementos, la administración de canalizaciones, el manejo de solicitudes de extracción y la administración de sprints y políticas de rama.

  1. Overview
    1. Features
      1. Work Item Management
      2. Project Management
    2. Getting Started
      1. Prerequisites
      2. Installation
      3. Configuration
      4. Running the Server
    3. Usage Examples
      1. Query Work Items
      2. Create a Work Item
      3. Update a Work Item
      4. Team Management
      5. View Project Structure
    4. Development
      1. Contributing
        1. License
          1. Acknowledgments
            ID: 1t73gvug7p