Azure DevOps MCP代理（独立）
A. 独立 代理，将Azure DevOps MCP服务器（stdio）连接到HTTP/Streamable传输。 不需要MCP网关 -使用Docker在本地运行。
快速开始
选项1:Docker Compose（推荐）
- 配置您的组织：
cp .env.example .env
# Edit .env and set your ADO_ORGANIZATION- 启动代理：
docker compose up -d- 从VS代码连接：
这 .vcode/mcp.json 已配置。打开VS Code并使用Copilot与Azure DevOps进行交互。
选项2：Docker运行
docker build -t ado-mcp-proxy .
docker run -d -p 8000:8000 \
-e MCP_COMMAND=npx \
-e "MCP_ARGS=-y @azure-devops/mcp your-org-name" \
ado-mcp-proxy选项3：本地运行（Python）
# Install dependencies
pip install -r requirements.txt
# Set environment variables
$env:MCP_COMMAND = "npx"
$env:MCP_ARGS = "-y @azure-devops/mcp your-org-name"
# Run the proxy
python src/main.py配置
环境变量
| 变量 | 描述 | 默认值 |
|---|---|---|
MCP_COMMAND | 启动MCP服务器的命令 | npx |
MCP_ARGS | 命令的参数 | -y @azure-devops/mcp contoso |
MCP_HOST | 要绑定的主机 | 0.0.0.0 |
MCP_PORT | 要收听的端口 | 8000 |
MCP_PROXY_URL | （替代）远程HTTP MCP服务器的代理 | - |
认证
Azure DevOps MCP服务器需要凭据。选项：
- Azure CLI（建议用于本地开发）：
az login
# The container will use your Azure CLI credentials- 个人访问令牌：
$env:AZURE_DEVOPS_EXT_PAT = "your-pat-token"- Docker中的环境变量：
# docker-compose.yml
environment:
- AZURE_DEVOPS_EXT_PAT=${ADO_PAT}VS代码集成
这 .vscode/mcp.json 连接到代理 http://localhost:8000/mcp:
{
"servers": {
"azure-devops-proxy": {
"url": "http://localhost:8000/mcp"
}
}
}建筑
┌─────────────────┐ HTTP/Streamable ┌──────────────────┐ stdio ┌─────────────────┐
│ VS Code │ ──────────────────────▶│ MCP Proxy │ ──────────────▶│ Azure DevOps │
│ (Copilot) │ │ (FastMCP) │ │ MCP Server │
└─────────────────┘ :8000/mcp └──────────────────┘ npx └─────────────────┘文件
| 文件 | 目的 |
|---|---|
| src/main.py | 使用FastMCP的代理服务器 |
| 包含Node.js和Python的容器 | |
| 易于本地部署 | |
| .vcode/mcp.json | VS代码MCP配置 |
| 需求.txt | Python依赖关系 |
故障排除
代理未启动
- 确保已安装Node.js（需要
npx) - 检查组织名称是否正确
- 验证Azure凭据是否可用
连接被拒绝
- 检查代理是否正在运行：
docker compose logs - 验证端口8000是否未使用
身份验证错误
- 跑
az login刷新凭据 - 或设置
AZURE_DEVOPS_EXT_PAT具有有效的PAT