azure-devops-server-mcp-server

A minimal MCP (Model Context Protocol) server implementation for on-premises Azure DevOps Server, built with Python.

This project provides a simple bridge between LLM-based agents (via MCP) and a self-hosted Azure DevOps Server instance.

---

Features

This MCP server exposes the following tools:

• List Projects
  Retrieve basic information of all projects in the organization.

• Recent Work Items
  Fetch recently updated work items for a specified project.

• Recent Pipelines
  Retrieve recent pipeline (build) execution records and calculate success rates.

---

Requirements

• Python 3.9+
• Azure DevOps Server (on-premises)
• Azure DevOps Personal Access Token (PAT) with read-only permissions

---

Security Notice

• This project requires an Azure DevOps Personal Access Token (PAT).
  Never hard-code credentials in source code. Use environment variables instead.

• This project is intended for local, trusted environments only.

• The MCP server exposes project metadata and work item summaries to the connected LLM.
  Do not use it with untrusted or public LLM endpoints.

---

Disclaimer

This project is not affiliated with or endorsed by Microsoft.

---

VS Code MCP Configuration Example

Create a mcp.json file under .vscode/ in your workspace.

⚠️ The following configuration is for reference only.
Adjust paths according to your local environment.

{
  "servers": {
    "azure-devops-server": {
      "type": "stdio",
      "command": "<path-to-python-interpreter>",
      "args": [
        "<path-to-azure-devops-server-mcp-server.py>"
      ]
    }
  }
}