Azure DevOps MCP Server

> Model Context Protocol (MCP) server for Azure DevOps - Seamlessly integrate Azure DevOps pipelines, work items, pull requests, and repositories with GitHub Copilot CLI and other MCP clients.


🚀 Features

- Pipeline Management: List pipelines, get runs, analyze failures
- Build Monitoring: Get build logs, track failed builds
- Work Items: Query bugs, tasks, user stories with flexible filtering
- Pull Requests: Monitor PR status across repositories
- Repository Management: List and explore Git repositories
- AI-Powered Analysis: Intelligent failure analysis and recommendations
- Secure: PAT-based authentication with secure credential storage
- Cross-Platform: Works on Windows, macOS, and Linux

📦 Installation

``bash
npm install -g copilot-devops-mcp
`

🛠️ Quick Setup

Run the interactive setup wizard:

`bash
npm run setup

or

devops-mcp setup
`

The wizard will:
1. ✅ Collect your Azure DevOps credentials
2. ✅ Validate connection to your organization
3. ✅ Securely save configuration
4. ✅ Register with GitHub Copilot CLI

$3

Set these environment variables:

`bash

Windows (PowerShell)

setx DEVOPS_ORGANIZATION "https://dev.azure.com/yourorg"
setx DEVOPS_PROJECT "YourProject"
setx DEVOPS_PAT "your_personal_access_token"

Linux/macOS

export DEVOPS_ORGANIZATION="https://dev.azure.com/yourorg"
export DEVOPS_PROJECT="YourProject"
export DEVOPS_PAT="your_personal_access_token"
`

🔑 Creating a Personal Access Token (PAT)

1. Go to Azure DevOps → User Settings → Personal Access Tokens
2. Click "New Token"
3. Set expiration and scopes:
- ✅ Build: Read
- ✅ Code: Read
- ✅ Work Items: Read
4. Copy the token (you won't see it again!)

📖 Detailed guide: docs/devops-setup.md

🎯 Usage Examples

$3

`bash

Analyze recent failures

gh copilot "Show me failed pipeline runs from last week"

Get build logs

gh copilot "Show me the logs for build #12345"

Check pull requests

gh copilot "List all active pull requests"

Query work items

gh copilot "What bugs are assigned to me?"

Repository overview

gh copilot "List all repositories in the project"
`

$3

`bash

Validate connection

devops-mcp validate

List pipelines

devops-mcp list-pipelines

Check for failures

devops-mcp check-failures

List repositories

devops-mcp list-repos

List work items

devops-mcp list-work-items
`

🔧 Available Tools

The MCP server provides 8 powerful tools:

$3

List all pipelines in your Azure DevOps project.

Example: "Show me all pipelines"

$3

Get recent runs for a specific pipeline.

Example: "Show me the last 10 runs of pipeline 42"

$3

Get only failed pipeline runs (project-wide or specific pipeline).

Example: "Show me all failed builds from the last 7 days"

$3

Get logs for a specific build or list available logs.

Example: "Get logs for build 12345"

$3

AI-powered analysis of recent failures with insights and recommendations.

Example: "Analyze pipeline failures from last week"

$3

List work items with filtering by type, state, assignee.

Example: "Show me all active bugs assigned to @Me"

$3

Get pull requests with status filtering.

Example: "Show me all active pull requests"

$3

List all Git repositories in the project.

Example: "List all repositories"

📖 Full API reference: docs/api.md

📚 Documentation

- Installation Guide - Detailed setup instructions
- Usage Guide - Complete usage examples
- API Reference - All tools and parameters
- Azure DevOps Setup - PAT creation and permissions
- Security Best Practices - Keep your credentials safe

🔒 Security

- Never commit your PAT to version control
- Store PAT in environment variables only
- Use minimal required permissions
- Rotate tokens regularly
- See SECURITY.md for detailed guidance

🤝 Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines.

$3

`bash

Clone repository

git clone https://github.com/GiDanis/copilot-devops-mcp.git
cd copilot-devops-mcp

Install dependencies

npm install

Run setup

npm run setup

Test the server

npm start
`

📋 Requirements

- Node.js: 18.0.0 or higher
- Azure DevOps: Organization with project access
- PAT: Personal Access Token with appropriate permissions

🐛 Troubleshooting

$3

Run devops-mcp setup` to configure credentials.

$3

Check if your PAT is valid and not expired.

$3

Verify organization URL and project name are correct (case-sensitive).

$3

Restart your terminal after setup.

📝 License

MIT © Giuseppe Danise

See LICENSE file for details.

🔗 Links

- GitHub: https://github.com/GiDanis/copilot-devops-mcp
- NPM: https://www.npmjs.com/package/copilot-devops-mcp
- Issues: https://github.com/GiDanis/copilot-devops-mcp/issues

✨ Acknowledgments

Built with:
- @modelcontextprotocol/sdk - MCP SDK
- Azure DevOps REST API - Official API
- axios - HTTP client
- chalk - Terminal styling
- inquirer - Interactive CLI

---

Made with ❤️ for the Azure DevOps community