MCP Azure DevOps Server

by Vortiago
Verified

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.

Integrations

  • Enables repository operations for Azure DevOps Git repositories, supporting features like pull request management (planned).

  • Allows installation of the MCP server package from PyPI, making deployment easier through standard Python package management.

  • Built using Python SDK for MCP implementation, requiring Python 3.9+ for server installation and operation.

MCP Azure DevOps 服务器

模型上下文协议 (MCP) 服务器使 AI 助手能够与 Azure DevOps 服务进行交互。

概述

该项目实现了一个模型上下文协议 (MCP) 服务器,允许 AI 助手(如 Claude)与 Azure DevOps 交互,在自然语言交互和 Azure DevOps REST API 之间架起一座桥梁。

特征

目前已实施:

工作项管理

  • 查询工作项:使用 WIQL 查询搜索工作项
  • 获取工作项详细信息:查看完整的工作项信息
  • 创建工作项:添加新任务、错误、用户故事和其他工作项类型
  • 更新工作项:修改现有工作项的字段和属性
  • 添加评论:对工作项目发表评论
  • 查看评论:检索工作项的评论历史记录
  • 父子关系:建立工作项之间的层次结构

项目管理

  • 获取项目:查看组织中所有可访问的项目
  • 获取团队:列出组织内的所有团队
  • 团队成员:查看团队成员信息
  • 团队区域路径:检索分配给团队的区域路径
  • 团队迭代:访问团队迭代/冲刺配置

计划的功能:

  • 管道操作:查询管道状态并触发新的管道运行
  • 拉取请求处理:创建、更新和审查拉取请求
  • Sprint 管理:规划和管理 Sprint 和迭代
  • 分支策略管理:配置和管理分支策略

入门

先决条件

  • Python 3.10+
  • 具有适当权限的 Azure DevOps 帐户
  • 个人访问令牌 (PAT),具有 Azure DevOps API 访问所需的范围

安装

# Clone the repository git clone https://github.com/Vortiago/mcp-azure-devops.git cd mcp-azure-devops # Install in development mode uv pip install -e ".[dev]" # Install from PyPi pip install mcp-azure-devops

配置

在项目根目录中创建一个.env文件,其中包含以下变量:

AZURE_DEVOPS_PAT=your_personal_access_token AZURE_DEVOPS_ORGANIZATION_URL=https://your-organization.visualstudio.com or https://dev.azure.com/your-organisation

注意:请确保提供 Azure DevOps 组织的完整 URL。

运行服务器

# Development mode with the MCP Inspector mcp dev src/mcp_azure_devops/server.py # Install in Claude Desktop mcp install src/mcp_azure_devops/server.py --name "Azure DevOps Assistant"

使用示例

查询工作项

Show me all active bugs assigned to me in the current sprint

创建工作项

Create a user story in the ProjectX with the title "Implement user authentication" and assign it to john.doe@example.com

更新工作项

Change the status of bug #1234 to "Resolved" and add a comment explaining the fix

团队管理

Show me all the team members in the "Core Development" team in the "ProjectX" project

查看项目结构

List all projects in my organization and show me the iterations for the Development team

发展

该项目分为多个功能模块,每个模块都实现特定的 Azure DevOps 功能:

  • features/work_items :工作项管理功能
  • features/projects :项目管理能力
  • features/teams :团队管理功能
  • utils :常用实用程序和客户端初始化

有关开发的更多信息,请参阅CLAUDE.md文件。

贡献

欢迎贡献代码!欢迎提交 Pull 请求。

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息,请参阅LICENSE文件。

致谢

You must be authenticated.

A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

模型上下文协议服务器使 AI 助手能够与 Azure DevOps 服务进行交互,允许用户查询有计划的工作项,以支持创建/更新项目、管理管道、处理拉取请求以及管理冲刺和分支策略。

  1. Overview
    1. Features
      1. Work Item Management
      2. Project Management
    2. Getting Started
      1. Prerequisites
      2. Installation
      3. Configuration
      4. Running the Server
    3. Usage Examples
      1. Query Work Items
      2. Create a Work Item
      3. Update a Work Item
      4. Team Management
      5. View Project Structure
    4. Development
      1. Contributing
        1. License
          1. Acknowledgments
            ID: 1t73gvug7p