Harness MCP Server

Harness MCP Server 是一个 模型上下文协议 (MCP) 服务器，它提供了与 Harness API 的无缝集成，使开发者和工具能够实现高级自动化和交互能力。

目录

• 组件
  • 工具集
    • 默认工具集
    • 流水线工具集
    • 拉取请求工具集
    • 服务工具集
    • 环境工具集
    • 基础设施工具集
    • 连接器工具集
    • 仓库工具集
    • 注册表工具集
    • 仪表板工具集
    • 云成本管理工具集
    • 数据库操作工具集
    • 混沌工程工具集
    • 供应链安全 (SCS) 工具集
    • 安全测试编排 (STO) 工具集
    • 日志工具集
    • 模板工具集
    • 内部开发者门户工具集
    • 审计跟踪工具集
    • 特性管理和实验 (FME) 工具集
• 前提条件
• 快速开始
• Makefile 使用
• 从源码构建
• 使用 Docker 镜像
  • 标准 I/O 模式
  • HTTP 模式
• 在本地 Kubernetes 集群上运行
• 与 AI 助手集成
  • 与 Gemini CLI 集成
  • 与 Gemini CLI 扩展集成
  • Claude Desktop 配置
  • 与 Claude Code 集成
  • 与 Windsurf 集成
    • 使用本地二进制文件
    • 在 HTTP 服务器模式下
    • 使用 Docker 镜像
  • 与 Amazon Q 开发者 CLI 集成
    • 使用本地二进制文件
  • Cursor 配置
  • VS Code 配置
• 工具使用指南
  • 下载执行日志
    • 使用 Docker
    • 使用本地二进制文件
• 开发
  • 命令行参数
  • 环境变量
  • 认证
  • 使用 create_follow_up_prompt 工具生成可操作提示事件
• 本地测试注意事项
  • 示例
• 调试
• 测试
  • 运行端到端测试

组件

工具集

服务器实现了多个工具集：

默认工具集

默认工具集包含了来自各种服务的基本工具：

工具集名称：default

• get_connector_details: 获取特定连接器的详细信息
• list_connector_catalogue: 列出 Harness 连接器目录
• list_connectors: 列出连接器并提供过滤选项
• list_pipelines: 列出仓库中的流水线
• get_pipeline: 获取特定流水线的详细信息
• get_execution: 获取特定流水线执行的详细信息
• list_executions: 列出流水线执行
• fetch_execution_url: 获取流水线执行的执行 URL
• list_dashboards: 列出所有可用的 Harness 仪表板
• get_dashboard_data: 从特定的 Harness 仪表板中检索数据

流水线工具集

工具集名称：pipelines

• get_pipeline: 获取特定流水线的详细信息
• list_pipelines: 列出仓库中的流水线
• get_execution: 获取特定流水线执行的详细信息
• list_executions: 列出流水线执行
• fetch_execution_url: 获取流水线执行的执行 URL

拉取请求工具集

工具集名称：pullrequests

• get_pull_request: 获取特定拉取请求的详细信息
• list_pull_requests: 列出仓库中的拉取请求
• get_pull_request_checks: 获取特定拉取请求的状态检查
• get_pull_request_activities: 获取特定拉取请求的活动和评论
• create_pull_request: 创建新的拉取请求

服务工具集

工具集名称：services

• get_service: 获取特定服务的详细信息
• list_services: 列出服务

环境工具集

工具集名称：environments

• get_environment: 获取特定环境的详细信息
• list_environments: 列出环境
• move_environment_configs: 将环境 YAML 从内联移动到远程

基础设施工具集

工具集名称：infrastructure

• list_infrastructures: 列出基础设施定义
• move_infrastructure_configs: 在内联和远程之间移动基础设施 YAML

连接器工具集

工具集名称：connectors

• list_connector_catalogue: 列出 Harness 连接器目录
• get_connector_details: 获取特定连接器的详细信息
• list_connectors: 列出连接器并提供过滤选项

仓库工具集

工具集名称：repositories

• get_repository: 获取特定仓库的详细信息
• list_repositories: 列出仓库

注册表工具集

工具集名称：registries

• get_registry: 获取 Harness 软件包注册表中特定注册表的详细信息
• list_artifact_files: 列出 Harness 软件包注册表中特定软件包版本的文件
• list_artifact_versions: 列出 Harness 软件包注册表中的软件包版本
• list_artifacts: 列出 Harness 软件包注册表中的软件包
• list_registries: 列出 Harness 软件包注册表中的注册表

仪表板工具集

工具集名称：dashboards

• list_dashboards: 列出所有可用的 Harness 仪表板
• get_dashboard_data: 从特定的 Harness 仪表板中检索数据

云成本管理工具集

工具集名称：ccm

• get_ccm_overview: 获取特定账户的成本概览。
• list_ccm_cost_categories: 列出指定账户的所有成本类别名称。
• list_ccm_cost_categories_detail: 列出指定账户的所有成本类别详细信息。
• get_ccm_cost_category: 根据 Id 获取指定账户的成本类别详细信息。
• list_ccm_perspectives_detail: 列出指定账户的所有视角。
• get_ccm_perspective: 根据 Id 获取指定账户的视角。
• get_last_period_cost_ccm_perspective: 获取指定账户内给定期间和视角的成本。
• get_last_twelve_months_cost_ccm_perspective: 获取指定账户内过去 12 个月的每月成本细分。
• create_ccm_perspective: 为指定账户创建视角。
• update_ccm_perspective: 更新指定账户的视角。
• delete_ccm_perspective: 删除指定账户的视角。
• ccm_perspective_grid: 查询 Harness 云成本管理中的详细成本视角数据。
• ccm_perspective_time_series: 查询 Harness 云成本管理中的详细成本视角数据，并按时间分组。
• ccm_perspective_summary_with_budget: 查询 Harness 云成本管理中的成本视角摘要，包括按时间分组的详细成本和预算数据。
• `cc[...]
• get_ccm_metadata: 获取关于可用云连接器、成本数据源、默认视角和货币偏好的元数据。
• ccm_perspective_recommendations: 返回每月成本、节省额以及 Harness 云成本管理中特定视角的开放建议列表。
• ccm_perspective_filter_values: 返回成本视角的有效过滤值，允许在 Harness 云成本管理中动态发现高级查询的有效选项。
• list_ccm_recommendations: 返回 Harness 云成本管理中的可筛选成本优化建议列表。
• list_ccm_recommendations_by_resource_type: 返回给定账户内按资源类型聚合的云成本优化建议统计信息。
• get_ccm_recommendations_stats: 返回给定账户内的云成本优化建议总体统计信息。
• update_ccm_recommendation_state: 在 Harness 云成本管理中标记建议为已应用/打开/忽略。
• override_ccm_recommendation_savings: 在 Harness 云成本管理中覆盖建议的节省金额。
• create_jira_ticket_for_ccm_recommendation: 为 Harness 云成本管理中的建议创建 Jira 工单。
• create_service_now_ticket_for_ccm_recommendation: 为 Harness 云成本管理中的建议创建 Service Now 工单。
• get_ec2_recommendation_detail: 返回给定建议标识符的 ECS 建议详细信息。
• get_azure_vm_recommendation_detail: 返回给定建议标识符的 Azure VM 建议详细信息。
• get_ecs_service_recommendation_detail: 返回给定建议标识符的 ECS 服务建议详细信息。
• get_node_pool_recommendation_detail: 返回给定建议标识符的节点池建议详细信息。
• get_workload_recommendation_detail: 返回给定建议标识符的工作负载建议详细信息。
• list_jira_projects: 返回可用于为 Harness 云成本管理中的建议创建工单的 Jira 项目列表。
• list_jira_issue_types: 返回可用于为 Harness 云成本管理中的建议创建工单的 Jira 问题类型列表。
• get_ccm_anomalies_summary: 返回指定账户的成本异常摘要。
• list_ccm_anomalies: 返回指定账户的成本异常列表。
• list_ccm_ignored_anomalies: 返回指定账户的忽略成本异常列表。
• get_ccm_anomalies_for_perspective: 返回指定视角和账户的成本异常。
• list_all_ccm_anomalies: 返回指定账户的所有成本异常列表。
• list_filter_values_ccm_anomalies: 返回指定账户内所有指定异常的唯一值列表。
• report_ccm_anomaly_feedback: 报告指定账户内异常的反馈。
• get_ccm_commitment_coverage: 获取账户的承诺覆盖率信息。
• get_ccm_commitment_savings: 获取账户的承诺节省信息。
• get_ccm_commitment_utilisation: 获取账户的承诺利用率信息，按预留实例和节省计划逐日细分。
• get_ccm_estimated_savings: 获取云账户的估算节省信息。
• get_ccm_commitment_ec2_analysis: 获取账户的 AWS EC2 承诺分析，包括预留实例/节省计划支出、利用率细分、当前节省、年度化估算节省和 ESR。

数据库操作工具集

工具集名称：dbops

• get_database_schema_info: 获取数据库模式的元数据，包括其标识符、实例标识符和数据库类型。

混沌工程工具集

工具集名称：chaos

• chaos_experiments_list: 列出所有匹配范围和过滤器的混沌实验。
• chaos_experiment_describe: 获取特定混沌实验的详细信息。
• chaos_experiment_run: 运行特定的混沌实验。
• chaos_experiment_run_result: 获取特定混沌实验运行的结果。
• chaos_probes_list: 列出所有匹配范围和过滤器的混沌探测。
• chaos_probe_describe: 获取特定混沌探测的详细信息。
• chaos_create_experiment_from_template: 从模板创建新的混沌实验。
• chaos_experiment_template_list: 列出所有匹配范围和过滤器的混沌实验模板。
• chaos_experiment_variables_list: 列出特定混沌实验的所有变量。

供应链安全 (SCS) 工具集

工具集名称：scs

• list_artifact_sources: 列出特定组织和项目中 Harness SCS 中的所有软件包来源。
• list_artifacts_per_source: 列出特定软件包来源中的所有软件包。
• get_artifact_overview: 获取特定软件包的元数据、安全发现、SBOM 和合规状态。
• get_artifact_chain_of_custody: 获取特定软件包的完整保管链（事件历史）。
• fetch_compliance_results_by_artifact: 获取特定软件包的合规结果。
• get_code_repository_overview: 获取代码存储库的漏洞、SBOM、合规问题和策略违规概述。
• list_scs_code_repos: 列出 Harness SCS 扫描的所有代码存储库。

安全测试编排 (STO) 工具集

工具集名称：sto

• get_all_security_issues: 列出并筛选 Harness STO 中的安全问题，按目标、流水线、工具、严重性、豁免状态和类型进行筛选。
• global_exemptions: 列出 Harness STO 中的所有全局豁免。
• promote_exemption: 将特定豁免提升为全局豁免。
• approve_exemption: 批准特定豁免。

日志工具集

工具集名称：logs

• download_execution_logs: 下载流水线执行的日志

模板工具集

工具集名称：templates

• list_templates: 列出给定范围内的模板
• intelligent_template_search: 根据自然语言描述找到最相关的模板。

内部开发者门户工具集

工具集名称：idp

• get_entity: 获取 Harness IDP 目录中特定实体的详细信息
• list_entities: 列出 Harness 内部开发者门户目录中的实体
• get_scorecard: 获取 Harness IDP 目录中特定实体的详细信息
• list_scorecards: 列出 Harness 内部开发者门户目录中的评分卡
• get_score_summary: 获取 Harness 内部开发者门户目录中评分卡的评分摘要。
• get_scores: 获取 Harness 内部开发者门户目录中评分卡的评分。

审计跟踪工具集

工具集名称：audit

• list_user_audits: 获取指定用户的完整审计跟踪。

特性管理和实验 (FME) 工具集

工具集名称：fme

• list_fme_workspaces: 列出所有 FME 工作区
• list_fme_environments: 列出特定工作区的环境
• list_fme_feature_flags: 列出特定工作区的特性标志
• get_fme_feature_flag_definition: 获取特定环境中的特定特性标志定义

前提条件

1. 您需要在系统上安装 Go 1.23 或更高版本。
2. Harness API 密钥用于身份验证。

快速开始

Makefile 使用

此项目提供了一个 Makefile 来简化常见的开发任务。主要目标如下：

• make build – 构建带有嵌入版本信息的 mcp-server 二进制文件。
• make init – 设置 git 钩子和子模块以进行预提交检查。
• make dep – 下载 Go 模块依赖项。
• make tools – 安装构建所需的工具（如果有指定）。
• make format – 使用 goimports 和 gci 格式化 Go 代码。

您可以在项目根目录下运行这些命令中的任何一个。例如：

make build
make format

从源码构建

1. 克隆仓库：

git clone https://github.com/harness/mcp-server.git
cd mcp-server

2. 构建二进制文件：

go build -o cmd/harness-mcp-server/harness-mcp-server ./cmd/harness-mcp-server

3. 运行服务器：

HARNESS_API_KEY=your_api_key HARNESS_DEFAULT_ORG_ID=your_org_id HARNESS_DEFAULT_PROJECT_ID=your_project_id ./cmd/harness-mcp-server/harness-mcp-server stdio

使用 Docker 镜像

标准 I/O 模式

或者，您可以使用预构建的 Docker 镜像：

docker run -i --rm \
  -e HARNESS_API_KEY=your_api_key \
  -e HARNESS_BASE_URL=your_base_url \
  -e HARNESS_LOG_FILE=harness-mcp.log \
  harness/mcp-server stdio

可选环境变量：

1. HARNESS_DEFAULT_ORG_ID
2. HARNESS_DEFAULT_PROJECT_ID
3. HARNESS_LOG_FILE (默认：harness-mcp.log)

HTTP 模式

要作为 HTTP 服务器本地运行 MCP 服务器，必须设置以下环境变量：

1. HARNESS_BASE_URL
2. HARNESS_API_KEY

使用以下命令构建 Docker 镜像：

docker build -t harness-mcp-server .

运行 Docker 镜像：

docker run -p 8080:8080 -e HARNESS_BASE_URL=https://app.harness.io -e HARNESS_API_KEY=<PAT> -e HARNESS_LOG_FILE=harness-mcp.log harness-mcp-server http-server

在本地 Kubernetes