Harness 官方 MCP Server，通过 11 个精简工具路由至 139 种资源类型，为 AI Agent 提供对 Harness.io 全平台（CI/CD、GitOps、Feature Flags、云成本、安全测试等）的编程式访问能力。
Harness MCP Server 是 Harness Inc. 官方发布的 Model Context Protocol (MCP) 服务端实现，当前版本 0.9.0，采用 TypeScript 编写，运行于 Node.js ≥20 环境。
该项目核心设计理念是"精简工具集 + 注册表调度"：仅向 LLM 暴露 11 个语义清晰的 MCP 工具（list/get/create/update/delete/execute/search/diagnose/schema/status/describe），通过内部注册表路由到 139 种 Harness 资源类型，有效避免了工具数量膨胀导致的 LLM 工具选择退化问题。新增资源类型只需添加声明式数据文件，无需修改工具注册逻辑或 schema。
平台覆盖面广泛，包含 30 个 toolset：CI/CD Pipeline 管理、GitOps（Argo CD）、Feature Flags（含 Split.io FME）、Cloud Cost Management (CCM)、Security Testing Orchestration (STO)、Chaos Engineering、Internal Developer Portal (IDP)、Software Supply Chain Assurance (SCS)、Software Engineering Insights (SEI，含 DORA 指标)、Governance、Access Control 等。
传输层支持 stdio（适配 Claude Desktop / Cursor / Windsurf 等本地客户端）和 HTTP（session-based + SSE，适配远程/共享部署及多种 MCP Gateway）。安全机制包括写操作 Elicitation 用户确认、只读模式、结构化审计日志输出、客户端限流与自动重试。部署形态支持 npx 零安装启动、Docker 容器、Kubernetes（含完整 manifest，非 root 安全上下文）。内置 27 个预置 Prompt 模板，覆盖构建部署、故障排查、成本优化、漏洞分类等高频场景。仅需 HARNESS_API_KEY 即可零配置启动，Account ID 从 PAT token 自动提取，支持多项目动态发现与 Harness UI URL 自动解析。
安装方式#
npx 零安装（推荐）
HARNESS_API_KEY=pat.xxx.xxx.xxx npx harness-mcp-v2@latest
HARNESS_API_KEY=pat.xxx.xxx.xxx npx harness-mcp-v2@latest http --port 8080
全局安装
npm install -g harness-mcp-v2
harness-mcp-v2
Docker
docker run --rm -p 3000:3000 -e HARNESS_API_KEY=pat.xxx.xxx.xxx harness-mcp-server
Kubernetes
kubectl apply -f k8s/
关键环境变量#
| 变量 | 必填 | 默认值 | 说明 |
|---|---|---|---|
HARNESS_API_KEY | ✅ | — | Harness PAT 或 Service Account Token |
HARNESS_ACCOUNT_ID | 否 | 从 PAT 提取 | 仅非 PAT key 需要 |
HARNESS_BASE_URL | 否 | https://app.harness.io | 自托管 Harness 时覆盖 |
HARNESS_ORG | 否 | default | 默认组织 ID |
HARNESS_PROJECT | 否 | — | 默认项目 ID |
HARNESS_TOOLSETS | 否 | 全部 | 逗号分隔的 toolset 列表 |
HARNESS_READ_ONLY | 否 | false | 只读模式 |
HARNESS_SKIP_ELICITATION | 否 | false | 跳过写操作确认 |
HARNESS_API_TIMEOUT_MS | 否 | 30000 | API 超时 |
HARNESS_MAX_RETRIES | 否 | 3 | 重试次数（429/5xx） |
HARNESS_RATE_LIMIT_RPS | 否 | 10 | 客户端限流 |
待确认信息#
- npm 包
harness-mcp-v2的发布状态未在仓库中直接验证 - 139 种资源类型的完整清单有待从
data/schemas/目录确认 - v1.0 GA 时间线尚未明确
- Split.io (FME) 功能的具体权限配置细节未展开
- HTTP 传输模式下除环境变量外是否有额外请求级认证机制未明确