MCP Azure DevOps Server

Um servidor MCP (Model Context Protocol) para integração com o Azure DevOps, oferecendo acesso a Boards, Repos e Pipelines.

Ferramentas Disponíveis

📋 Boards — Leitura

Ferramenta	Descrição
getWorkItem	Recupera um work item pelo ID, com opção de expandir relações (parent/child)
getWorkItemsBatch	Recupera múltiplos work items por IDs em uma única requisição (até 200)
queryWorkItems	Executa uma WIQL query, com opção de retornar dados completos (fetchDetails)
listWorkItemTypes	Lista todos os tipos de work items e seus estados válidos no projeto

📋 Boards — Escrita

Ferramenta	Descrição
createWorkItem	Cria um work item (Epic, Feature, PBI, Task, Bug, Impediment) com campos completos e link de pai opcional
updateWorkItem	Atualiza campos arbitrários de um work item (título, descrição, tags, state, prioridade, etc.)
updateWorkItemState	Atalho para alterar apenas o estado de um work item
deleteWorkItem	Deleta um work item (lixeira ou destruição permanente)
addWorkItemComment	Adiciona um comentário a um work item

🔀 Repos

Ferramenta	Descrição
createPullRequest	Cria um Pull Request em um repositório do Azure DevOps
linkPullRequestToWorkItem	Vincula um PR existente a um Work Item

🚀 Pipelines

Ferramenta	Descrição
getPipelineStatus	Obtém o status da última execução de um pipeline

Configuração

Variáveis de ambiente obrigatórias:

AZURE_ORG=athosschrapett
AZURE_PROJECT=Arenar
AZURE_PAT=<seu-personal-access-token>

Uso via MCP Config

{
  "mcpServers": {
    "azure-devops": {
      "command": "node",
      "args": ["path/to/dist/server.js"],
      "env": {
        "AZURE_ORG": "sua-organizacao",
        "AZURE_PROJECT": "seu-projeto",
        "AZURE_PAT": "seu-personal-access-token"
      }
    }
  }
}

Build

npm install
npm run build

Changelog

v2.0.0

• Novo: createWorkItem — cria work items com todos os campos (título, descrição, AC, tags, prioridade, story points, iteração, área, assignee, parent link)
• Novo: updateWorkItem — atualiza campos arbitrários de um work item
• Novo: deleteWorkItem — deleta work items (lixeira ou permanente)
• Novo: listWorkItemTypes — lista tipos e estados válidos
• Novo: getWorkItemsBatch — recupera múltiplos work items por IDs em batch
• Melhorado: queryWorkItems — novo parâmetro fetchDetails para retornar dados completos
• Melhorado: getWorkItem — novo parâmetro expand para ver relações/links
• Fix: Config padrão atualizado para projeto Arenar
• Fix: Uso de org-level API para operações que não dependem de project scope