kimtth/mcp-azure-devops-client-demo
If you are the rightful owner of mcp-azure-devops-client-demo and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This document provides a comprehensive overview of the Azure DevOps MCP Server, detailing its features, tools, resources, and usage across different platforms.
Azure DevOps βΎοΈ Azure DevOps MCP Demo π¬
Minimal demo of interacting with Azure DevOps via an Azure DevOps MCP Server (projects, work items, repos, wiki).
Quick Start
- uv sync
- Set env vars (see the
.env.examples): AZURE_DEVOPS_ORG (e.g., contoso), AZURE_DEVOPS_PAT (Azure DevOps Personal Access Token)
[!NOTE] The sample shows how to authenticate with an Azure DevOps Personal Access Token (PAT). To use Azure CLI instead, simply omit the
ADO_MCP_AUTH_TOKENenvironment variable.
Usage
Examples:
- "List projects"
- "Get work item 10001 in DemoProject"
- "Create a task (preview) to update docs in DemoProject"
- "List open pull requests in DemoProject"
Sample MCP Interaction Outputs
1. List Projects
Prompt:
Get list of all projects in my Azure DevOps organization
Response:
Here are all projects in your Azure DevOps organization:
- DemoProject (ID: proj-001) β state: wellFormed β visibility: Private β last update: 2025-01-15T10:30:00Z
- WebApp (ID: proj-002) β state: wellFormed β visibility: Public β last update: 2025-01-10T14:20:00Z
- MobileApp (ID: proj-003) β state: wellFormed β visibility: Private β last update: 2024-12-20T08:15:00Z
2. Get My Work Items
Prompt:
Get my work items for project DemoProject
Response:
I found 15 work items assigned to you in project DemoProject. Here they are (ID β URL):
- 10001 β https://dev.azure.com/[ORG]/_apis/wit/workItems/10001
- 10002 β https://dev.azure.com/[ORG]/_apis/wit/workItems/10002
- 10003 β https://dev.azure.com/[ORG]/_apis/wit/workItems/10003
- 10004 β https://dev.azure.com/[ORG]/_apis/wit/workItems/10004
- 10005 β https://dev.azure.com/[ORG]/_apis/wit/workItems/10005
Would you like any of these opened for full details (title, state, assignee, description), filtered (by state/type), exported (CSV), or do something else with them?
3. List Teams
Prompt:
Get list of teams for project DemoProject
Response:
I found 8 teams in project "DemoProject":
- Core Team β team-001
- DevOps Team β team-002
- Frontend Team β team-003
- Backend Team β team-004
- QA Team β team-005
- Security Team β team-006
- Design Team β team-007
- Platform Team β team-008
Would you like any of these expanded with description, URL, or team membership?
4. Get Work Item Details
Prompt:
Get work item 10001 and show me the fields: ID, Type, State, Title, Assigned To, and Priority
Response:
Work Item 10001
- Type: Task
- State: Active
- Title: Update API documentation
- Assigned To: [REDACTED]
- Priority: 2
5. Create Work Item
Prompt:
Create a new Task in project DemoProject with title 'Update documentation' and description 'Need to update API documentation with latest changes'
Response:
β Successfully created Task 10015 in project DemoProject
Details:
- ID: 10015
- Type: Task
- Title: Update documentation
- Description: Need to update API documentation with latest changes
- State: New
- URL: https://dev.azure.com/[ORG]/DemoProject/_workitems/edit/10015
6. Update Work Item
Prompt:
Update work item 10001: set State to 'Active', Priority to 2, and add a comment 'Working on this now'
Response:
β Successfully updated work item 10001
Changes applied:
- State: New β Active
- Priority: 3 β 2
- Added comment: "Working on this now"
Current revision: 5
7. List Pull Requests
Prompt:
List all active pull requests for project DemoProject and repository webapp-frontend
Response:
Found 2 active pull requests in repository webapp-frontend:
-
PR #301 - Add user authentication feature
- Status: Active
- Source: feature/auth β main
- Created by: [REDACTED]
-
PR #302 - Fix navigation bug
- Status: Active
- Source: bugfix/nav β develop
- Created by: [REDACTED]
8. List Wikis
Prompt:
Get list of wikis in project DemoProject
Response:
Found 2 wikis in project DemoProject:
-
Name: DemoProject.wiki
- ID: wiki-001
- Type: Project wiki (type = 0)
- URL: https://dev.azure.com/[ORG]/[PROJECT]/_wiki/wikis/wiki-001
-
Name: Team Documentation
- ID: wiki-002
- Type: Code wiki (type = 1)
- URL: https://dev.azure.com/[ORG]/[PROJECT]/_wiki/wikis/wiki-002
Would you like the pages for either wiki or the content of a specific page?
9. Complex Query - Triage Bugs
Prompt:
For project DemoProject and team Core Team:
1. Get the current iteration
2. List all unassigned bugs with priority 1 or 2
3. Show me the top 5 by creation date
Response:
Current Iteration: Sprint 12
Found 12 unassigned bugs with priority 1 or 2. Here are the top 5 by creation date:
-
Bug 10101 - Critical: Database connection timeout
- Priority: 1
- State: New
- Created: 2025-01-15T09:23:00Z
-
Bug 10099 - Memory leak in background service
- Priority: 1
- State: Active
- Created: 2025-01-14T16:45:00Z
-
Bug 10087 - UI rendering issue on mobile
- Priority: 2
- State: New
- Created: 2025-01-13T11:30:00Z
-
Bug 10085 - API timeout on large requests
- Priority: 2
- State: New
- Created: 2025-01-12T14:20:00Z
-
Bug 10082 - Login redirect fails intermittently
- Priority: 1
- State: Active
- Created: 2025-01-11T10:15:00Z
Would you like to assign any of these or see more details?