AI导哈

Azure DevOps MCP代理

一个独立的代理服务，将Azure DevOps MCP服务器（stdio）桥接到HTTP/可流式传输通道，支持本地Docker运行。

  • by BoelenJ
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 BoelenJ/devops-mcp-proxy

使用说明

Azure DevOps MCP代理（独立）

A. 独立 代理，将Azure DevOps MCP服务器（stdio）连接到HTTP/Streamable传输。 不需要MCP网关 -使用Docker在本地运行。

快速开始

选项1:Docker Compose（推荐）

  1. 配置您的组织：

    cp .env.example .env
# Edit .env and set your ADO_ORGANIZATION

  2. 启动代理：

    docker compose up -d

  3. 从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服务器需要凭据。选项：

  1. Azure CLI（建议用于本地开发）：

    az login
# The container will use your Azure CLI credentials

  2. 个人访问令牌：

    $env:AZURE_DEVOPS_EXT_PAT = "your-pat-token"

  3. 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的代理服务器
Dockerfile 包含Node.js和Python的容器
docker-compose.yml 易于本地部署
.vcode/mcp.json VS代码MCP配置
需求.txt Python依赖关系

故障排除

代理未启动

  • 确保已安装Node.js（需要 npx)
  • 检查组织名称是否正确
  • 验证Azure凭据是否可用

连接被拒绝

  • 检查代理是否正在运行： docker compose logs
  • 验证端口8000是否未使用

身份验证错误

  • 跑 az login 刷新凭据
  • 或设置 AZURE_DEVOPS_EXT_PAT 具有有效的PAT

链接

相关 MCP