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
Uso
Para iniciar o servidor em modo desenvolvimento:
Para iniciar o servidor em modo produção:
Integração com Gemini CLI
Para usar este servidor MCP com o Gemini CLI, siga os passos abaixo:
1. Construir o projeto
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
4. Verificar configuração
5. Usar no Gemini CLI
Para mais detalhes sobre a configuração, consulte:
GEMINI_SETUP.md
- Configuração detalhadaMCP_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 DevOpsADO_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 DevOpsget_next_card
: retorna o próximo card da fila ordenada, útil para workflows de desenvolvimentocomplete_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çõesget_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
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.