harness-mcp-v2 3.2.22 → 3.2.23
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +16 -6
- package/build/data/schemas/v0/pipeline.d.ts.map +1 -1
- package/build/data/schemas/v0/pipeline.js +78 -108
- package/build/data/schemas/v0/pipeline.js.map +1 -1
- package/build/data/schemas/v0/template.d.ts.map +1 -1
- package/build/data/schemas/v0/template.js +78 -108
- package/build/data/schemas/v0/template.js.map +1 -1
- package/build/registry/extractors.d.ts +20 -1
- package/build/registry/extractors.d.ts.map +1 -1
- package/build/registry/extractors.js +105 -10
- package/build/registry/extractors.js.map +1 -1
- package/build/registry/toolsets/alerts.d.ts.map +1 -1
- package/build/registry/toolsets/alerts.js +6 -1
- package/build/registry/toolsets/alerts.js.map +1 -1
- package/build/registry/toolsets/deploys.d.ts.map +1 -1
- package/build/registry/toolsets/deploys.js +21 -8
- package/build/registry/toolsets/deploys.js.map +1 -1
- package/build/registry/toolsets/incidents.d.ts.map +1 -1
- package/build/registry/toolsets/incidents.js +4 -2
- package/build/registry/toolsets/incidents.js.map +1 -1
- package/build/registry/toolsets/pipelines.d.ts.map +1 -1
- package/build/registry/toolsets/pipelines.js +142 -18
- package/build/registry/toolsets/pipelines.js.map +1 -1
- package/build/registry/toolsets/related-activities.d.ts +29 -0
- package/build/registry/toolsets/related-activities.d.ts.map +1 -0
- package/build/registry/toolsets/related-activities.js +59 -0
- package/build/registry/toolsets/related-activities.js.map +1 -0
- package/build/tools/harness-execute.d.ts.map +1 -1
- package/build/tools/harness-execute.js +7 -1
- package/build/tools/harness-execute.js.map +1 -1
- package/build/utils/pipeline-v1-runtime-inputs.d.ts +3 -0
- package/build/utils/pipeline-v1-runtime-inputs.d.ts.map +1 -0
- package/build/utils/pipeline-v1-runtime-inputs.js +56 -0
- package/build/utils/pipeline-v1-runtime-inputs.js.map +1 -0
- package/build/utils/runtime-input-metadata.d.ts +18 -0
- package/build/utils/runtime-input-metadata.d.ts.map +1 -0
- package/build/utils/runtime-input-metadata.js +213 -0
- package/build/utils/runtime-input-metadata.js.map +1 -0
- package/npm-shrinkwrap.json +2 -2
- package/package.json +1 -1
package/README.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
[](https://mcptoplist.com/server/glama%2Fharness%2Fmcp-server)
|
|
4
4
|
|
|
5
|
-
An MCP (Model Context Protocol) server that gives AI agents full access to the Harness.io platform through 11 consolidated tools and
|
|
5
|
+
An MCP (Model Context Protocol) server that gives AI agents full access to the Harness.io platform through 11 consolidated tools and 243 resource types.
|
|
6
6
|
|
|
7
7
|
## Why Use This MCP Server
|
|
8
8
|
|
|
@@ -10,7 +10,7 @@ Most MCP servers map one tool per API endpoint. For a platform as broad as Harne
|
|
|
10
10
|
|
|
11
11
|
This server is built differently:
|
|
12
12
|
|
|
13
|
-
- **11 tools,
|
|
13
|
+
- **11 tools, 243 resource types.** A registry-based dispatch system routes `harness_list`, `harness_get`, `harness_create`, etc. to any Harness resource — pipelines, services, environments, orgs, projects, feature flags, cost data, and more. The LLM picks from 11 tools instead of hundreds.
|
|
14
14
|
- **Full platform coverage.** 40 default toolsets spanning CI/CD, GitOps, Feature Flags, Cloud Cost Management, Security Testing, Chaos Engineering, Database DevOps, Internal Developer Portal, Software Supply Chain, Infrastructure as Code Management, Release Management, Governance, Service Overrides, Knowledge Graph, and more. Opt-in Ansible coverage is available when you need inventory and playbook data.
|
|
15
15
|
- **Multi-project workflows out of the box.** Agents discover organizations and projects dynamically — no hardcoded env vars needed. Ask "show failed executions across all projects" and the agent can navigate the full account hierarchy.
|
|
16
16
|
- **35 prompt templates.** Pre-built prompts for common workflows: build & deploy apps end-to-end, debug failed pipelines, review DORA metrics, triage vulnerabilities, optimize cloud costs, audit access control, plan feature flag rollouts, review pull requests, approve pending pipelines, and more.
|
|
@@ -870,7 +870,7 @@ Maintainers can refresh the vendored entity snapshots with `pnpm sync-entity-sch
|
|
|
870
870
|
|
|
871
871
|
### Pipeline Run Workflow (Recommended)
|
|
872
872
|
|
|
873
|
-
|
|
873
|
+
For v0 pipelines, use this sequence to reduce execution-time input errors:
|
|
874
874
|
|
|
875
875
|
1. **Discover required runtime inputs**
|
|
876
876
|
- `harness_get(resource_type="runtime_input_template", resource_id="<pipeline_id>")`
|
|
@@ -905,6 +905,14 @@ Use this sequence to reduce execution-time input errors:
|
|
|
905
905
|
4. **Optional: combine both**
|
|
906
906
|
- Use `input_set_ids` for the base shape and `inputs` for simple overrides.
|
|
907
907
|
|
|
908
|
+
For v1 pipelines:
|
|
909
|
+
|
|
910
|
+
1. Fetch `harness_get(resource_type="runtime_input_template_v1", resource_id="<pipeline_id>")`.
|
|
911
|
+
For Git-backed pipelines, pass `branch_name`, `connector_ref`, and `repo_name` through `params`.
|
|
912
|
+
2. Use each returned `inputs[].details.name` as a top-level key in `harness_execute.inputs`.
|
|
913
|
+
3. Run `harness_execute(resource_type="pipeline_v1", action="run", resource_id="<pipeline_id>", inputs={...})`.
|
|
914
|
+
The server wraps these values under an `inputs:` YAML root and sends the API's `inputs_yaml` body.
|
|
915
|
+
|
|
908
916
|
If required fields are unresolved, the tool returns a pre-flight error with expected keys and suggested input sets. You can inspect available shorthand mappings with `harness_describe(resource_type="pipeline")` (`executeActions.run.inputShorthands`).
|
|
909
917
|
|
|
910
918
|
### Dynamic Pipeline Execution
|
|
@@ -1205,7 +1213,7 @@ Harness pipelines can be stored in three ways:
|
|
|
1205
1213
|
|
|
1206
1214
|
## Resource Types
|
|
1207
1215
|
|
|
1208
|
-
|
|
1216
|
+
243 resource types organized across 40 toolsets. Each resource type supports a subset of CRUD operations and optional execute actions.
|
|
1209
1217
|
|
|
1210
1218
|
### Platform
|
|
1211
1219
|
|
|
@@ -1230,10 +1238,12 @@ Harness pipelines can be stored in three ways:
|
|
|
1230
1238
|
| `pipeline_summary` | | x | | | | |
|
|
1231
1239
|
| `input_set` | x | x | x | x | x | |
|
|
1232
1240
|
| `runtime_input_template` | | x | | | | |
|
|
1241
|
+
| `runtime_input_template_v1` | | x | | | | |
|
|
1242
|
+
| `pipeline_resolved_yaml` | | x | | | | |
|
|
1233
1243
|
| `approval_instance` | x | | | | | `approve`, `reject` |
|
|
1234
1244
|
|
|
1235
1245
|
|
|
1236
|
-
|
|
1246
|
+
Both pipeline YAML resource types are available when the pipelines toolset is enabled. `HARNESS_PIPELINE_VERSION` and the HTTP `x-harness-pipeline-version` initialization header select the default version preference; they do not hide the other version.
|
|
1237
1247
|
|
|
1238
1248
|
### AI Agents
|
|
1239
1249
|
|
|
@@ -1928,7 +1938,7 @@ Available toolset names:
|
|
|
1928
1938
|
+--------v---------+
|
|
1929
1939
|
| Registry | <-- Declarative resource definitions
|
|
1930
1940
|
| 40 Toolsets | (data files, not code)
|
|
1931
|
-
|
|
|
1941
|
+
| 243 Resource Types|
|
|
1932
1942
|
+--------+---------+
|
|
1933
1943
|
|
|
|
1934
1944
|
+--------v---------+
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../../src/data/schemas/v0/pipeline.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,
|
|
1
|
+
{"version":3,"file":"pipeline.d.ts","sourceRoot":"","sources":["../../../../src/data/schemas/v0/pipeline.ts"],"names":[],"mappings":"AAGA,QAAA,MAAM,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAkgzH/B,CAAC;AACF,eAAe,MAAM,CAAC"}
|
|
@@ -61298,10 +61298,19 @@ const schema = {
|
|
|
61298
61298
|
"type": "string"
|
|
61299
61299
|
},
|
|
61300
61300
|
"gitFetchType": {
|
|
61301
|
-
"
|
|
61302
|
-
|
|
61303
|
-
|
|
61304
|
-
|
|
61301
|
+
"oneOf": [
|
|
61302
|
+
{
|
|
61303
|
+
"type": "string",
|
|
61304
|
+
"enum": [
|
|
61305
|
+
"Branch",
|
|
61306
|
+
"Commit"
|
|
61307
|
+
]
|
|
61308
|
+
},
|
|
61309
|
+
{
|
|
61310
|
+
"type": "string",
|
|
61311
|
+
"pattern": "(<\\+.+>.*)",
|
|
61312
|
+
"minLength": 1
|
|
61313
|
+
}
|
|
61305
61314
|
]
|
|
61306
61315
|
},
|
|
61307
61316
|
"paths": {
|
|
@@ -61324,20 +61333,6 @@ const schema = {
|
|
|
61324
61333
|
}
|
|
61325
61334
|
}
|
|
61326
61335
|
},
|
|
61327
|
-
{
|
|
61328
|
-
"oneOf": [
|
|
61329
|
-
{
|
|
61330
|
-
"required": [
|
|
61331
|
-
"commitId"
|
|
61332
|
-
]
|
|
61333
|
-
},
|
|
61334
|
-
{
|
|
61335
|
-
"required": [
|
|
61336
|
-
"branch"
|
|
61337
|
-
]
|
|
61338
|
-
}
|
|
61339
|
-
]
|
|
61340
|
-
},
|
|
61341
61336
|
{
|
|
61342
61337
|
"oneOf": [
|
|
61343
61338
|
{
|
|
@@ -61386,10 +61381,19 @@ const schema = {
|
|
|
61386
61381
|
"type": "string"
|
|
61387
61382
|
},
|
|
61388
61383
|
"gitFetchType": {
|
|
61389
|
-
"
|
|
61390
|
-
|
|
61391
|
-
|
|
61392
|
-
|
|
61384
|
+
"oneOf": [
|
|
61385
|
+
{
|
|
61386
|
+
"type": "string",
|
|
61387
|
+
"enum": [
|
|
61388
|
+
"Branch",
|
|
61389
|
+
"Commit"
|
|
61390
|
+
]
|
|
61391
|
+
},
|
|
61392
|
+
{
|
|
61393
|
+
"type": "string",
|
|
61394
|
+
"pattern": "(<\\+.+>.*)",
|
|
61395
|
+
"minLength": 1
|
|
61396
|
+
}
|
|
61393
61397
|
]
|
|
61394
61398
|
},
|
|
61395
61399
|
"paths": {
|
|
@@ -61412,20 +61416,6 @@ const schema = {
|
|
|
61412
61416
|
}
|
|
61413
61417
|
}
|
|
61414
61418
|
},
|
|
61415
|
-
{
|
|
61416
|
-
"oneOf": [
|
|
61417
|
-
{
|
|
61418
|
-
"required": [
|
|
61419
|
-
"commitId"
|
|
61420
|
-
]
|
|
61421
|
-
},
|
|
61422
|
-
{
|
|
61423
|
-
"required": [
|
|
61424
|
-
"branch"
|
|
61425
|
-
]
|
|
61426
|
-
}
|
|
61427
|
-
]
|
|
61428
|
-
},
|
|
61429
61419
|
{
|
|
61430
61420
|
"oneOf": [
|
|
61431
61421
|
{
|
|
@@ -61552,10 +61542,19 @@ const schema = {
|
|
|
61552
61542
|
"type": "string"
|
|
61553
61543
|
},
|
|
61554
61544
|
"gitFetchType": {
|
|
61555
|
-
"
|
|
61556
|
-
|
|
61557
|
-
|
|
61558
|
-
|
|
61545
|
+
"oneOf": [
|
|
61546
|
+
{
|
|
61547
|
+
"type": "string",
|
|
61548
|
+
"enum": [
|
|
61549
|
+
"Branch",
|
|
61550
|
+
"Commit"
|
|
61551
|
+
]
|
|
61552
|
+
},
|
|
61553
|
+
{
|
|
61554
|
+
"type": "string",
|
|
61555
|
+
"pattern": "(<\\+.+>.*)",
|
|
61556
|
+
"minLength": 1
|
|
61557
|
+
}
|
|
61559
61558
|
]
|
|
61560
61559
|
},
|
|
61561
61560
|
"paths": {
|
|
@@ -61578,20 +61577,6 @@ const schema = {
|
|
|
61578
61577
|
}
|
|
61579
61578
|
}
|
|
61580
61579
|
},
|
|
61581
|
-
{
|
|
61582
|
-
"oneOf": [
|
|
61583
|
-
{
|
|
61584
|
-
"required": [
|
|
61585
|
-
"commitId"
|
|
61586
|
-
]
|
|
61587
|
-
},
|
|
61588
|
-
{
|
|
61589
|
-
"required": [
|
|
61590
|
-
"branch"
|
|
61591
|
-
]
|
|
61592
|
-
}
|
|
61593
|
-
]
|
|
61594
|
-
},
|
|
61595
61580
|
{
|
|
61596
61581
|
"oneOf": [
|
|
61597
61582
|
{
|
|
@@ -61640,10 +61625,19 @@ const schema = {
|
|
|
61640
61625
|
"type": "string"
|
|
61641
61626
|
},
|
|
61642
61627
|
"gitFetchType": {
|
|
61643
|
-
"
|
|
61644
|
-
|
|
61645
|
-
|
|
61646
|
-
|
|
61628
|
+
"oneOf": [
|
|
61629
|
+
{
|
|
61630
|
+
"type": "string",
|
|
61631
|
+
"enum": [
|
|
61632
|
+
"Branch",
|
|
61633
|
+
"Commit"
|
|
61634
|
+
]
|
|
61635
|
+
},
|
|
61636
|
+
{
|
|
61637
|
+
"type": "string",
|
|
61638
|
+
"pattern": "(<\\+.+>.*)",
|
|
61639
|
+
"minLength": 1
|
|
61640
|
+
}
|
|
61647
61641
|
]
|
|
61648
61642
|
},
|
|
61649
61643
|
"paths": {
|
|
@@ -61666,20 +61660,6 @@ const schema = {
|
|
|
61666
61660
|
}
|
|
61667
61661
|
}
|
|
61668
61662
|
},
|
|
61669
|
-
{
|
|
61670
|
-
"oneOf": [
|
|
61671
|
-
{
|
|
61672
|
-
"required": [
|
|
61673
|
-
"commitId"
|
|
61674
|
-
]
|
|
61675
|
-
},
|
|
61676
|
-
{
|
|
61677
|
-
"required": [
|
|
61678
|
-
"branch"
|
|
61679
|
-
]
|
|
61680
|
-
}
|
|
61681
|
-
]
|
|
61682
|
-
},
|
|
61683
61663
|
{
|
|
61684
61664
|
"oneOf": [
|
|
61685
61665
|
{
|
|
@@ -61728,10 +61708,19 @@ const schema = {
|
|
|
61728
61708
|
"type": "string"
|
|
61729
61709
|
},
|
|
61730
61710
|
"gitFetchType": {
|
|
61731
|
-
"
|
|
61732
|
-
|
|
61733
|
-
|
|
61734
|
-
|
|
61711
|
+
"oneOf": [
|
|
61712
|
+
{
|
|
61713
|
+
"type": "string",
|
|
61714
|
+
"enum": [
|
|
61715
|
+
"Branch",
|
|
61716
|
+
"Commit"
|
|
61717
|
+
]
|
|
61718
|
+
},
|
|
61719
|
+
{
|
|
61720
|
+
"type": "string",
|
|
61721
|
+
"pattern": "(<\\+.+>.*)",
|
|
61722
|
+
"minLength": 1
|
|
61723
|
+
}
|
|
61735
61724
|
]
|
|
61736
61725
|
},
|
|
61737
61726
|
"paths": {
|
|
@@ -61754,20 +61743,6 @@ const schema = {
|
|
|
61754
61743
|
}
|
|
61755
61744
|
}
|
|
61756
61745
|
},
|
|
61757
|
-
{
|
|
61758
|
-
"oneOf": [
|
|
61759
|
-
{
|
|
61760
|
-
"required": [
|
|
61761
|
-
"commitId"
|
|
61762
|
-
]
|
|
61763
|
-
},
|
|
61764
|
-
{
|
|
61765
|
-
"required": [
|
|
61766
|
-
"branch"
|
|
61767
|
-
]
|
|
61768
|
-
}
|
|
61769
|
-
]
|
|
61770
|
-
},
|
|
61771
61746
|
{
|
|
61772
61747
|
"oneOf": [
|
|
61773
61748
|
{
|
|
@@ -62248,10 +62223,19 @@ const schema = {
|
|
|
62248
62223
|
"type": "string"
|
|
62249
62224
|
},
|
|
62250
62225
|
"gitFetchType": {
|
|
62251
|
-
"
|
|
62252
|
-
|
|
62253
|
-
|
|
62254
|
-
|
|
62226
|
+
"oneOf": [
|
|
62227
|
+
{
|
|
62228
|
+
"type": "string",
|
|
62229
|
+
"enum": [
|
|
62230
|
+
"Branch",
|
|
62231
|
+
"Commit"
|
|
62232
|
+
]
|
|
62233
|
+
},
|
|
62234
|
+
{
|
|
62235
|
+
"type": "string",
|
|
62236
|
+
"pattern": "(<\\+.+>.*)",
|
|
62237
|
+
"minLength": 1
|
|
62238
|
+
}
|
|
62255
62239
|
]
|
|
62256
62240
|
},
|
|
62257
62241
|
"paths": {
|
|
@@ -62274,20 +62258,6 @@ const schema = {
|
|
|
62274
62258
|
}
|
|
62275
62259
|
}
|
|
62276
62260
|
},
|
|
62277
|
-
{
|
|
62278
|
-
"oneOf": [
|
|
62279
|
-
{
|
|
62280
|
-
"required": [
|
|
62281
|
-
"commitId"
|
|
62282
|
-
]
|
|
62283
|
-
},
|
|
62284
|
-
{
|
|
62285
|
-
"required": [
|
|
62286
|
-
"branch"
|
|
62287
|
-
]
|
|
62288
|
-
}
|
|
62289
|
-
]
|
|
62290
|
-
},
|
|
62291
62261
|
{
|
|
62292
62262
|
"oneOf": [
|
|
62293
62263
|
{
|