Azure DevOps代码模式服务器

ado代码模式mcp

此仓库包含一个本地Azure DevOps MCP服务器，该服务器使用 Cloudflare的代码模式 使用直接的Azure DevOps REST API目录。

当前的实施存在于 apps/ado-codemode-mcp 并遵循与Cloudflare的API实验相同的基本形状：

• search 让模型检查根据官方Swagger规范构建的静态Azure DevOps REST操作目录
• execute 让模型运行一个调用Azure DevOps的JavaScript程序 operationId
• Azure DevOps身份验证不在沙盒内
• 生成的代码在隔离的本地沙箱中运行

早期的MCP包裹实验保存在树枝上 feat/mcp-wrap该版本封装了Azure DevOps MCP服务器，而不是使用直接的REST合约，但最终作为主要方法效果不佳。

公共MCP表面

默认情况下，服务器只公开：

• search
• execute

调试工具，如 health 和 list_capabilities 仅在以下情况下暴露：

export ADO_CODEMODE_MCP_EXPOSE_DEBUG_TOOLS=1

回购布局

• apps/ado-codemode-mcp -主MCP服务器和本地测试
• packages/sandbox-executor -沙盒启动器和回调处理
• packages/sandbox-protocol -沙盒回调协议类型
• docker/sandbox-runner -最小沙盒运行时映像
• docs/architecture.md -系统架构和流程图
• docs/architecture-decisions.md -关键设计决策
• docs/local-setup-macos.md -本地设置和烟雾测试步骤
• docs/threat-model.md -安全边界和后续行动

快速开始

安装依赖项：

bun install

设置最低Azure DevOps配置：

export AZDO_ORGANIZATION=your-organization

启动MCP服务器：

bun run dev:ado-codemode-mcp

运行测试和类型检查：

bun run test:ado-codemode-mcp
bun run typecheck

推荐使用模式

当OpenCode使用此MCP服务器时：

• 使用 search 一次缩小相关Azure DevOps REST操作的范围
• 使用一个组合 execute 只要可行，就按任务调用
• 链上 response.data 在单执行程序内部
• 当Azure DevOps路径失败时，停止并报告阻止程序，而不是退回到无关的工具

为什么这种方法获胜

直接的REST目录比包装Azure DevOps MCP表面更好，因为模型可以看到API合同中的输入和输出模式。

这为代码模式提供了足够的信息：

• 寻找正确的操作
• 了解预期的请求形状
• 一次执行调用中较长链返回数据的原因

看 feat/mcp-wrap 对于之前的包装实验和 docs/architecture-decisions.md 因为这一转变背后的原因。