Azure DevOps Multi-Organization MCP Server

Azure DevOps多组织MCP服务器

这是Azure DevOps的专用模型上下文协议（MCP）服务器，旨在克服标准实现中单个组织绑定的局限性。

🚀 价值主张与比较

这种实现的主要价值是 多组织支持 和 上下文优化.

🛠 建筑

1.连接管理器模式

此服务器使用 ConnectionManager 类。

• 延迟加载：只有在请求工具时，才会建立与Azure DevOps的连接。
• 缓存：缓存经过身份验证的连接，以确保后续请求的性能。
• 路由：每个工具模式都包含一个 organization 争论。管理员使用此功能从以下位置查找相应的个人访问令牌（PAT） config.json.

2.模块化工具结构

为了便于维护，工具被组织成单独的模块：

• tools/organizations.ts：组织和项目发现工具
• tools/pipelines.ts：CI/CD管道操作（构建、定义、运行、日志）
• tools/repositories.ts：Git存储库和拉取请求管理
• tools/common.ts：用于枚举处理和类型转换的共享实用程序
• tools/index.ts：中央注册协调器

3.上下文窗口优化

标准Azure DevOps API响应非常详细，通常包含完整的编排计划、日志和深度嵌套。此实现在以下工具中拦截这些响应 pipelines_get_builds 和 pipelines_get_build_definitions 致：

• 限制结果：默认为前20/50项，而不是数百项。
• 压平物体：将复杂对象映射到简单的键值对（例如。， { requestedFor: { displayName: "User" } } 仅变为显示名称）。
• 条形噪声：删除未使用的URL、大型配置blob和系统元数据。

4.双重运输支持

• 标准运输：用于本地使用Claude Desktop和VS Code（默认）
• 苏格兰和南方能源公司运输：用于具有HTTP端点的云部署（通过激活 PORT 任何人）

📦 配置

1.先决条件

• Node.js（v18或更高版本）
• 具有适当权限的Azure DevOps个人访问令牌（PAT）：

- 代码（读取）：用于存储库和拉取请求操作 - 构建（读取并执行）：用于管道和建筑作业 - 项目和团队（阅读）：用于组织和项目列表

2.设置 config.json

创建 config.json 根目录中的文件。此文件映射您的组织名称（如URL中显示的名称，例如。， dev.azure.com/{org})他们的PAT。

{
  "org-1": "your-pat-token-here",
  "org-2": "another-pat-token-here"
}

3.构建和运行

npm install
npm run build

4.克劳德桌面配置（本地-标准）

将服务器添加到您的 claude_desktop_config.json 本地使用：

{
  "mcpServers": {
    "azure-devops-multi": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-server-azure-devops-multi/dist/index.js"
      ]
    }
  }
}

5.VS代码配置（本地-标准）

将服务器添加到您的VS代码设置中，以便与GitHub Copilot Chat一起使用：

1. 打开VS代码设置（JSON）
2. 增添 github.copilot.chat.mcp.servers:

{
  "github.copilot.chat.mcp.servers": {
    "Azure DevOps Multi": {
      "command": "node",
      "args": [
        "/absolute/path/to/mcp-server-azure-devops-multi/dist/index.js"
      ]
    }
  }
}

6.云部署（HTTP/SSE）

服务器支持用于云部署的SSE（服务器发送事件）传输：

Docker构建与运行

docker build -t azdo-mcp-server .
docker run -p 3000:3000 -v /path/to/config.json:/app/config.json azdo-mcp-server

Azure容器应用

az containerapp create \
  --name azdo-mcp-server \
  --resource-group  \
  --environment  \
  --image .azurecr.io/azdo-mcp-server:latest \
  --target-port 3000 \
  --ingress external \
  --env-vars PORT=3000

当发生以下情况时，服务器会自动切换到SSE传输 PORT 设置环境变量，暴露：

• GET /sse -SSE连接端点
• POST /messages -消息处理端点

🧰 可用工具（共18个）

组织和项目（2个工具）

• list_organizations：查看中的所有已配置组织 config.json.
• list_projects：列出特定组织内的所有项目。

管道和建筑（13个工具）

• pipelines_get_builds：列出带有过滤选项的最新版本（针对上下文进行了优化）。
• pipelines_get_build_definitions：列出带有查询选项的构建定义（针对上下文进行了优化）。
• pipelines_get_build_status：获取特定版本的详细报告。
• pipelines_get_build_log：检索特定版本的日志。
• pipelines_get_build_timeline：获取构建的时间线条目。
• pipelines_run_pipeline：使用参数和变量触发新的管道运行。
• pipelines_get_run：获取特定管道运行的详细信息。
• pipelines_list_runs：列出带有过滤选项的管道运行。
• pipelines_get_run_stage：获取有关管道运行中特定阶段的信息。
• pipelines_get_run_log：获取特定管道运行的日志内容。
• pipelines_update_build_stage：更新构建中的阶段（占位符-尚未实现）。
• pipelines_get_definition：按ID获取特定的构建定义。
• pipelines_get_definition_yaml：获取管道定义的YAML内容。

Git仓库和拉取请求（5个工具）

• git_list_repositories：列出项目中的所有Git存储库。
• git_get_repository：获取特定存储库的详细信息。
• git_get_pull_requests：使用过滤选项搜索和列出拉取请求。
• git_create_pull_request：创建一个包含标题、描述和审阅者的新拉取请求。
• git_get_item：从具有版本控制选项的存储库中获取文件或文件夹内容。