← 返回目录

Harness MCP Server

官方

通过 11 个统一工具访问 Harness.io 全平台的官方 MCP 服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 开发工具第 74 / 438
Stars: ★ 105 热门
传输方式: stdio（本地进程） · Streamable HTTP
运行环境: Node.js · Docker
凭据: 需要 API Key / 凭据
许可证: MIT
最近提交: 2 天前
工具数: 11

63FMRS · C

基于 README 描述，这是 Harness 官方维护的多工具、多资源类型 MCP 服务器，功能覆盖全面且提供细致的配置与安全说明，但写操作权限较大，部署时需谨慎配置鉴权与只读模式。

最强项 · 文档质量 17/20 最弱项 · 可靠性 8/20

可靠性

8/20

安全与权限

15/20

维护活跃度

10/20

文档质量

17/20

安装易用性

13/20

查看各项评分依据

可靠性 8/20: README声称提供11个工具、224种资源类型，并提到pnpm inspect、test-remote-provider.mjs等测试脚本，但本次为静态审查，未能看到实际提交的CI工作流文件或测试覆盖证据，也无法验证'11个工具'与'224个资源类型'的实际实现是否与文档描述一致。根据静态校准规则，在缺乏可验证的CI+测试证据时，可靠性不得超过12分。文档中HTTP会话管理、等待轮询、错误提示等设计思路合理，但均为未经验证的书面声明，故评分保守。
安全与权限 15/20: 安全设计документation显示较强的纵深考虑：默认强制HTTPS（HARNESS_ALLOW_HTTP显式开启才允许例外）、非回环绑定默认要求HARNESS_MCP_AUTH_TOKEN、多用户模式下服务器不持有凭据而是逐会话传递、破坏性操作（create/update/delete/execute）通过elicitation要求用户确认、HARNESS_AUTO_APPROVE_RISK的会话级上限受部署级配置封顶而非扩大、HARNESS_READ_ONLY可禁用所有写操作、审计日志（文件/webhook/OTel）覆盖注册表调度的操作。未发现红线级问题（无硬编码凭据、无默认无确认的破坏性操作）。扣分点：这些保护机制均来自README声明，未见实际代码验证；且DNS-rebinding防护和CORS被文档明确指出'不是身份验证'，说明仍需外部把关，存在配置疏漏导致暴露的可能性。
维护活跃度 10/20: 仓库为MIT许可、未归档，但87星对应83个未关闭issue，issue数量相对星标数偏高，可能反映维护跟进压力较大。未提供commit频率、release节奏或最近提交时间等信息，无法判断当前维护活跃度和治理规范程度，因此保守评分。
文档质量 17/20: 文档非常详尽：涵盖前置条件、多种安装方式（npx/全局安装/源码构建/Docker/K8s）、HTTP传输的完整端点说明、多用户模式、大量环境变量表格（含默认值和用途）、审计与可观测性配置、语义搜索三种provider对比及本地测试步骤、11个工具的详细参考表、多个真实工具调用示例、故障排查（如npx ENOENT）等。分层清晰、示例充分，公开了已知限制（如pipeline_dynamic_execution不支持部分特性、Alpha阶段的pipeline_v1）。轻微扣分：部分深层实现细节（如资源类型的完整列表未展示全）仍需读者自行探索。
安装易用性 13/20: 提供多种主流客户端（Claude Desktop、Cursor、Claude Code、Devin Desktop）的配置示例，以及npx零安装、全局安装、Docker、Kubernetes等多路径，并附带PATH问题的故障排查指南。根据静态校准规则，在无法验证实际执行成功（无真实CI跑通记录）的情况下，setup不得超过15分。整体步骤描述清晰但依赖多个外部凭据获取步骤（Harness API Key生成流程）及环境差异（GUI应用PATH问题），故评为13分。

静态评测 · 未实际运行收录于 2026-08-26

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络修改第三方账户数据

适合谁

已使用 Harness 平台进行 CI/CD、GitOps 或 Feature Flags 管理的团队
需要跨多个组织/项目动态发现资源而非硬编码配置的自动化工作流
希望通过网关（Docker MCP Gateway、Portkey、LiteLLM 等）集中治理和审计工具调用的企业环境

不适合谁

不使用 Harness 平台的团队
希望为每个 API 端点单独映射工具、需要细粒度工具权限控制的场景
无法提供 Harness API Key 或未获得 Harness Support 开通托管 MCP 服务的账户

所需权限

需要一个 Harness 个人访问令牌（PAT）或服务账户令牌（SAT），账户 ID 通常从令牌中自动提取
默认具备读写权限（创建/更新/删除/执行），可通过 HARNESS_READ_ONLY=true 限制为只读
多用户 HTTP 模式下每个会话需提供各自的 x-harness-api-key，服务器本身不持有凭证

风险与副作用

写操作（创建、更新、删除、执行）可直接修改生产流水线、功能开关或基础设施配置，操作不当可能造成服务中断
HTTP 传输若未设置 HARNESS_MCP_AUTH_TOKEN 且绑定非回环地址，可能被未授权访问；HARNESS_MCP_ALLOW_UNAUTHENTICATED_HTTP=true 会显式关闭该保护
日志/审计功能默认不记录原始请求体，但可通过 HARNESS_LOG_UNSAFE_BODIES 开启，需注意其中可能包含密钥等敏感信息

安装接入

准备工作

运行环境：Node.js · Docker

HARNESS_API_KEY 必填密钥 Harness 个人访问令牌(PAT)或服务账户令牌(SAT),格式 pat.<accountId>.<tokenId>.<secret>;在 Harness 网页 My Profile → API Keys 中创建。

HARNESS_MCP_AUTH_TOKEN 可选密钥 HTTP 部署时 /mcp 路由要求的 Bearer 令牌,自部署远程环境必设;自行生成。

HARNESS_FME_API_KEY 可选密钥可选的 FME/Split Admin 凭据,用于 fme_ 资源;来自 Split/FME 后台或 FME 授权的 Harness 令牌。

HARNESS_SEARCH_SERVICE_HEADERS 可选密钥发送给远程搜索服务的 JSON 请求头,可承载任意认证方案;含凭据时视为机密。

HARNESS_AUDIT_WEBHOOK_TOKEN 可选密钥发送到审计 webhook 的可选 Bearer 令牌。

其他可选配置项（31 个）

HARNESS_ACCOUNT_ID 可选 Harness 账户 ID;PAT/SAT 令牌已内嵌账户 ID 时通常无需设置。

HARNESS_BASE_URL 可选 Harness API/UI 基础地址,默认 https://app.harness.io;私有环境(如 harness0)时自行设置。

HARNESS_ORG 可选默认组织 ID,工具调用未传 org_id 时使用;可选。

HARNESS_PROJECT 可选默认项目 ID,工具调用未传 project_id 时使用;可选。

HARNESS_MCP_MODE 可选部署模式:single-user(默认)或 multi-user(多用户 HTTP)。

HARNESS_READ_ONLY 可选设为 true 时阻止所有写操作,仅允许 list/get,适合共享或演示环境。

HARNESS_TOOLSETS 可选逗号分隔的工具集过滤列表,控制暴露哪些资源类别;默认加载 38 个默认工具集。

HARNESS_FME_BASE_URL 可选 Split/FME Admin API 地址,默认 https://api.split.io。

HARNESS_SEARCH_PROVIDER 可选 harness_search 的语义搜索后端:local(默认)、remote 或 none。

HARNESS_SEARCH_SERVICE_URL 可选 remote 搜索服务的基地址,使用 remote 提供者时必填。

HARNESS_AUTO_APPROVE_RISK 可选自动审批风险阈值(none/low_write/medium_write/high_write/all),控制哪些变更免确认。

HARNESS_ALLOW_HTTP 可选允许非 HTTPS 的 HARNESS_BASE_URL,仅限本地开发使用。

HARNESS_PIPELINE_VERSION 可选 Pipeline YAML 版本(0 或 1,Alpha),决定加载 pipeline 还是 pipeline_v1 资源。

HARNESS_MCP_ALLOWED_HOSTS 可选 HTTP 传输允许的 Host 头主机名列表,用于防 DNS 重绑定。

HARNESS_MCP_ALLOW_UNAUTHENTICATED_HTTP 可选显式允许非回环接口上的无认证 HTTP,慎用。

HARNESS_API_TIMEOUT_MS 可选对 Harness API 的请求超时毫秒数,默认 30000。

HARNESS_MAX_RETRIES 可选对瞬时失败(429/5xx)的重试次数,默认 3。

HARNESS_MAX_BODY_SIZE_MB 可选 HTTP 传输最大请求体大小(MB),默认 10。

HARNESS_RATE_LIMIT_RPS 可选客户端对 Harness API 的限流(每秒请求数),默认 10。

LOG_LEVEL 可选日志级别:debug/info/warn/error,默认 info。

HARNESS_MCP_LOG_FILE 可选 stdio 断连/崩溃诊断日志文件路径,默认 ~/.claude/harness-mcp.log。

HARNESS_LOG_UNSAFE_BODIES 可选是否在日志中包含原始请求/响应体,默认关闭以避免泄露机密。

HARNESS_AUDIT_FILE 可选审计事件追加写入的 NDJSON 文件路径,用于本地持久采集。

HARNESS_AUDIT_WEBHOOK_URL 可选接收批量审计事件的 HTTPS webhook 地址。

HARNESS_AUDIT_WEBHOOK_BATCH_SIZE 可选审计 webhook 批量刷新前的事件数,默认 10。

HARNESS_AUDIT_WEBHOOK_FLUSH_MS 可选审计事件 webhook 刷新前最长等待毫秒数,默认 5000。

OTEL_EXPORTER_OTLP_ENDPOINT 可选配置后启用 OpenTelemetry 审计 span(需安装可选 OTel 依赖包)。

HARNESS_HF_CACHE_DIR 可选本地语义搜索 HuggingFace 模型缓存目录,默认 /tmp/hf-cache。

HARNESS_DIAGNOSE_LOG_FETCH_CONCURRENCY 可选 harness_diagnose 并发下载日志 blob 的上限,默认 3。

HARNESS_MCP_TRUST_PROXY 可选信任的反向代理跳数,用于按真实客户端 IP 限流,默认 0。

HARNESS_SKIP_ELICITATION 可选已弃用,请改用 HARNESS_AUTO_APPROVE_RISK=all;保留向后兼容。

登录 Harness 账户，在“My Profile → API Keys → + New API Key”下创建一个 Token（生成格式为 <prefix>.<accountId>.<tokenId>.<secret> 的 PAT 或 SAT）。
推荐方式：无需安装，直接运行 HARNESS_API_KEY=pat.xxx.xxx.xxx npx harness-mcp-v2@latest；或先 npm install -g harness-mcp-v2 后全局安装运行；也可 git clone 仓库后用 pnpm 构建（pnpm install && pnpm build）。
在客户端配置文件中添加 mcpServers 条目，指定 command 为 npx 或已安装的 harness-mcp-v2 可执行文件的绝对路径，并在 env 中设置 HARNESS_API_KEY（GUI 客户端还需显式设置 PATH 以包含 node 所在目录，避免出现 npx ENOENT 报错）。
如需远程/共享部署，使用 npx harness-mcp-v2 http --port 8080 启动 HTTP 传输，并设置 HARNESS_MCP_AUTH_TOKEN 等安全相关环境变量。

claude_desktop_config.json

{"mcpServers":{"harness":{"command":"/absolute/path/to/npx","args":["-y","harness-mcp-v2@latest"],"env":{"HARNESS_API_KEY":"pat.xxx.xxx.xxx","PATH":"/directory/containing/node:/usr/local/bin:/usr/bin:/bin"}}}}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

{
  "servers": {
    "harness": {
      "command": "/absolute/path/to/npx",
      "args": [
        "-y",
        "harness-mcp-v2@latest"
      ],
      "env": {
        "HARNESS_API_KEY": "pat.xxx.xxx.xxx",
        "PATH": "/directory/containing/node:/usr/local/bin:/usr/bin:/bin"
      }
    }
  }
}

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add harness -e HARNESS_API_KEY=pat.xxx.xxx.xxx -e PATH=/directory/containing/node:/usr/local/bin:/usr/bin:/bin -- /absolute/path/to/npx -y harness-mcp-v2@latest

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

在客户端配置中填入 HARNESS_API_KEY 并重启后,工具列表中应出现 11 个 harness_ 工具(如 harness_list、harness_execute);可发起对话"列出我账户中的组织",能返回 Harness 组织列表即证明连接成功。

常见排障

遇到 `spawn npx ENOENT` 或 `node: No such file or directory`，说明是客户端进程启动失败而非鉴权问题，需用 `which npx`/`which node` 找到绝对路径并在配置的 env.PATH 中显式包含 node 所在目录
HTTP 模式下若设置了非 HTTPS 的 HARNESS_BASE_URL，服务器会拒绝启动，需设置 HARNESS_ALLOW_HTTP=true 仅用于本地开发
托管 MCP 端点（mcp.harness.io）使用 Harness Platform OAuth 而非 HARNESS_API_KEY，需先由 Harness Support 为账户启用该功能

试试这样问

连接成功后，可以直接对 AI 助手这样说：

列出我 Harness 账户里的所有组织和项目
搜索名称包含 deploy 的 pipeline 并显示最近一次执行的报告
创建一个构建 Go 应用并部署到 Kubernetes 的 pipeline
诊断执行 abc123XYZ 失败的 pipeline,告诉我失败的阶段和原因

工具能力 11

harness_describe 只读

发现可用的资源类型、操作和字段，仅返回本地注册表元数据，不发起 API 调用。

harness_schema 只读

获取用于创建/更新资源的精确 YAML/JSON Schema 定义和示例，支持按路径深入查看嵌套字段。

harness_list 只读

按类型列出资源，支持过滤、搜索和分页。

harness_get 只读

通过标识符获取单个资源。

harness_create 写入

创建新资源，支持内联和远程（Git 托管）流水线，写操作前会请求用户确认。

harness_update 写入

更新现有资源，支持内联和远程（Git 托管）流水线，写操作前会请求用户确认。

harness_delete 破坏性

删除资源，属于破坏性操作，执行前会请求用户确认。

harness_execute 写入

对资源执行动作（运行/重试流水线、从 Git 导入流水线、切换功能开关、同步应用等），执行前会请求用户确认。

展开其余 3 个工具

harness_search 只读

使用本地 ONNX 语义嵌入模型跨资源类型进行单次查询搜索，语义置信度低时回退到关键字扫描。

harness_diagnose 只读

诊断流水线、连接器、delegate 和 GitOps 应用，返回阶段/步骤耗时、失败详情及健康排障信号。

harness_status 只读

获取项目实时健康仪表盘，包括最近执行记录、失败率和深层链接。

使用场景

让 AI 代理自动构建、部署、调试 CI/CD 流水线并跨项目排查失败执行

通过自然语言触发功能开关切换、GitOps 应用同步或云成本查询

审计访问控制、追踪 DORA 指标、规划漏洞修复与功能发布

支持客户端

Claude Desktop

Claude Code

Cursor

Devin Desktop

依据项目文档列出，未经本站实测。

详细介绍

Harness MCP Server 2.0 是 Harness 官方维护的 Model Context Protocol 服务器，为 AI 代理提供对 Harness.io 平台的完整访问能力。它没有为每个 API 端点单独设计工具，而是用 11 个统一工具（harness_list、harness_get、harness_create 等）通过基于注册表的分发系统路由到 224 种资源类型，覆盖 CI/CD、GitOps、Feature Flags、云成本管理、安全测试、混沌工程、数据库 DevOps、内部开发者门户、软件供应链、基础设施即代码、治理等 38 个默认工具集。服务器支持通过 npx 零安装启动、全局安装或从源码构建，提供 stdio（本地客户端）和 HTTP（远程/共享部署）两种传输方式，并可部署到 Docker 或 Kubernetes。使用时只需提供 Harness API Key（PAT 或 SAT），账户 ID 会自动从令牌中提取。写操作（创建、更新、删除、执行）默认会通过 elicitation 机制请求用户确认，也可配置基于风险等级的自动批准阈值。