ado-mcp-server

Servidor MCP (Model Context Protocol) para integração com Azure DevOps Boards. Permite interagir com work items através de uma interface padronizada, facilitando automações e integrações com ferramentas que suportam o protocolo MCP.

Instalação

pnpm install

Uso

Para iniciar o servidor em modo desenvolvimento:

sh start-mcp-dev.sh

Para iniciar o servidor em modo produção:

sh start-mcp-server.sh

Integração com Gemini CLI

Para usar este servidor MCP com o Gemini CLI, siga os passos abaixo:

1. Construir o projeto

pnpm install pnpm run build

2. Configurar variáveis de ambiente

Crie um arquivo .env com suas credenciais do Azure DevOps ou configure as variáveis diretamente no gemini-mcp-config.json.

3. Adicionar ao Gemini CLI

# Navegue para o diretório do projeto cd ado-mcp-server # Adicione o servidor MCP ao Gemini CLI gemini mcp add ado-mcp node --enable-source-maps dist/index.js --cwd $(pwd)

4. Verificar configuração

gemini mcp list

5. Usar no Gemini CLI

gemini --model='gemini-2.0-flash'

Para mais detalhes sobre a configuração, consulte:

GEMINI_SETUP.md - Configuração detalhada
MCP_GEMINI_SETUP.md - Instruções específicas do MCP

Requisitos

Node.js 18+: runtime JavaScript necessário
pnpm: gerenciador de pacotes (recomendado)
Azure DevOps Personal Access Token: token de acesso com permissões de leitura/escrita nos work items
Configuração de ambiente: arquivo .env com as seguintes variáveis:
- ADO_PAT: Personal Access Token do Azure DevOps
- ADO_ORG: URL completa da organização (ex: https://dev.azure.com/minhaorg)
- ADO_PROJECT: Nome do projeto no Azure DevOps

Ferramentas MCP expostas

O servidor MCP expõe as seguintes ferramentas para integração com o Azure DevOps:

list_work_items: lista todos os work items ordenados pela query configurada no Azure DevOps
get_next_card: retorna o próximo card da fila ordenada, útil para workflows de desenvolvimento
complete_card: atualiza o estado de um work item específico (ex.: mover para "Done", "In Progress", etc.)
add_comment: adiciona comentários em work items para documentar progresso ou observações
get_top_cards: retorna os N primeiros work items da fila ordenada (padrão: 5), ideal para visualizar prioridades

Colaboração

Contribuições são bem-vindas! Para colaborar:

Fork: Faça um fork do repositório
Branch: Crie uma branch para sua feature ou correção (git checkout -b feature/nova-funcionalidade)
Commit: Faça commits descritivos das suas mudanças
Push: Envie suas mudanças (git push origin feature/nova-funcionalidade)
Pull Request: Abra um pull request descrevendo as alterações

Licença

MIT

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

How are these scores calculated?

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.

Enables interaction with Azure DevOps Boards through the Model Context Protocol. Supports work item management including listing, updating status, adding comments, and retrieving prioritized cards for development workflows.

Azure DevOps MCP Server