Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MCP_HCL_OUTPUT_ROOTYesOutput root for staged artifacts and operation receipts, e.g. D:\mcp-hcl\staged
MCP_HCL_INSTALL_ROOTYesPath to the HCL (H3C Cloud Lab) installation root, e.g. E:\HCL
MCP_HCL_PROJECT_ROOTSYesAllowed HCL project root path(s), e.g. C:\Users\me\HCL\Projects
MCP_HCL_ALLOW_LIVE_WRITENoControls whether device-mutating tools are allowed. Defaults to 0, in which case write tools return a refusal instead of touching a device.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
hcl_capabilitiesB

Describe verified capabilities and the activation boundary.

hcl_list_devicesB

List installed HCL model defaults, with file evidence and firmware boundaries.

hcl_get_device_detailsC

Read one installed model's default interfaces; never claim guest CLI verification.

hcl_validate_planB

Validate intent and, by default, require a connected declared wired topology.

Use Comware interface names, not .net scene port keys. Validation does not prove firmware support, deployment or actual network connectivity. configuration checks individual intents without requiring one wired component.

hcl_parity_reportB

Read the pinned mapping and API differences against current MCP discovery.

hcl_bridge_statusB

Probe the local HCL backend; never infer GUI or CLI control from it.

hcl_stage_copyB

Create an isolated HCL project for safe live-gate verification.

hcl_list_projectsA

List HCL projects immediately under configured project roots.

hcl_inspect_projectB

Read devices and links from one saved HCL project without changing it.

hcl_stage_add_deviceC

Copy a project, add a device cloned from a known model, and optionally link it.

hcl_stage_linkC

Copy a project and add a reciprocal link between two free ports.

hcl_backend_capabilitiesA

List the observed backend verbs, their evidence level and gating state.

Read-only and offline: it never opens a socket. The verb list comes from HCL's own logs, not from vendor documentation.

hcl_backend_topologyA

Open, inspect or close the backend topology session (state-changing).

The wrapper keys its topology to the connection, so opening keeps one connection alive and reuses it for hcl_device_power. At most one session is held at a time.

action is open, close or status. open needs topology and a working_directory inside a configured project root.

hcl_device_powerA

Power one device on through the observed backend verb (gated).

Requires an open session from hcl_backend_topology: the wrapper keys the topology to the connection, so a one-shot request is answered with errorCode=228. Only power-on was observed - no stop verb exists in the logs, so on=False is reported as unsupported rather than guessed.

hcl_console_execA

Send one line to a device console over HCL's telnet bridge (gated).

Supply either pipe (\\.\pipe\<topology>-device<N> or telnet://127.0.0.1:<30001..31024>) or topology plus device; the default endpoint for a topology is the telnet bridge HCL publishes for that device. Output that arrived before the command is drained and reported as discarded_stale_bytes so stale console text cannot be mistaken for this request's answer.

hcl_stage_planB

Compile a validated plan into a separate .net project using real source models.

Replaces source devices/notes in the copy. Every linked CLI port needs an explicit model-to-scene map. Command transcripts stay outside startup configs. No GUI open, VM creation, power, CLI deployment or connectivity is claimed by a staged result.

hcl_list_modulesD

Read the documented native NIC mode and fixed profiles; model compatibility is unverified.

hcl_list_templatesC

List deterministic HCL-native graph templates.

hcl_plan_topologyC

Build a deterministic plan from a strict TopologyRequest; never deploy.

hcl_estimate_planD

Use the same planner to count devices, links, addresses and services.

hcl_explain_planC

Explain a valid saved plan and its evidence boundaries without an LLM.

hcl_fix_planC

Return a repaired copy; preserve manually supplied addresses and services.

hcl_generate_configsB

Generate documented Comware templates for ten typed services, offline only.

hcl_generate_operationsC

Generate a declarative HCL operation manifest; executable=false until live adapters are accepted.

hcl_export_artifactsB

Atomically export an offline plan/config/operation bundle under the output root.

hcl_load_planB

Hash-check and reload an exported plan; never open the HCL GUI.

hcl_open_projectB

Open a staged .net in an existing SimwareClient (write-gated); no guest boot or CLI deployment.

hcl_save_projectC

Verify the active staged project identity, save it and parse the saved files (write-gated).

hcl_full_buildB

Plan and compile an isolated HCL project, optionally open it in an existing GUI.

activate defaults false. No VM power or CLI deployment occurs. Offline builds support durable idempotency; live activation is never replayed.

hcl_stage_rename_deviceB

Rename one device and both ends of its saved links in a new project copy.

hcl_stage_move_deviceB

Move one saved device in an isolated project copy; no live canvas mutation.

hcl_stage_delete_deviceC

Remove one saved device and reciprocal links from a separate project copy.

hcl_stage_unlinkB

Remove exactly one reciprocal saved link from an isolated copy.

hcl_stage_add_noteD

Append a bounded note in the observed .net representation to a copy.

hcl_stage_clear_annotationsB

Remove observed NOTE blocks only; preserve unknown drawing/Non-vBox data.

hcl_backup_configC

Create and test a native running-config backup for a bound staged device (gated).

hcl_restore_configB

Restore a tested native backup and compare the complete running configuration (gated).

hcl_live_deployC

Back up all staged devices before deployment; restore modified devices on failure (gated).

hcl_verify_connectivityC

Parse bounded actual ping statistics from a bound staged console; never infer success from exit status.

hcl_inspect_portsB

Read bound running-device interface state; empty device inspects all staged devices.

Link/cable inventory remains unverified, so only_linked=true is rejected.

hcl_read_vlansB

Read detailed native VLAN state from one bound staged device; no default or capacity guesses.

hcl_read_qosB

Read native user-defined traffic classes, behaviors and policies from one bound device.

hcl_diffD

Compare planned addresses with freshly bound guest observations.

Missing/extra live devices and a positive in_sync remain unknown until an authoritative native topology inventory is available.

hcl_health_checkC

Read interface anomalies and repeated addresses from staged running guests.

Carrier state does not prove cabling; healthy remains unknown.

hcl_audit_securityC

Audit bound running Comware configuration posture without exporting credentials.

Empty device selects staged non-PC bindings, not a complete native canvas inventory. Unsupported Cisco rules and unknown storage algorithms prevent a secure=true verdict.

hcl_apply_netstreamB

Apply/remove a scoped NetStream destination with local exporter-name identity.

Named NetFlow monitor/object equivalence and actual collector delivery remain unverified.

hcl_apply_stpC

Apply per-VLAN rapid spanning-tree priority and selected edge/guard intent.

Native PVST, root-selection and global BPDU protection are not full IOS equivalence claims.

hcl_apply_port_securityB

Apply bounded secure-MAC/shutdown intent on one existing access port.

Refuses unproved IOS protect/restrict mappings and unrequested authentication or learned-state conversion.

hcl_apply_interface_tuningB

Tune requested interface bandwidth and OSPF fields with scoped readback and saved recovery.

Serial clock and IOS delay mappings remain unavailable; encrypted authentication values are partial. Secrets are omitted from operation receipts and previews.

hcl_apply_natB

Apply static, dynamic or interface/pool PAT intent to one staged router.

Uses recorded ACL/pool identities, bounded backup/readback/persistence and same-VM recovery. Comware outbound semantics and pool ranges do not prove IOS ingress-role/netmask equivalence.

hcl_remove_natB

Remove exact NAT mappings, binding and optional unshared ACL/pool resources.

Reused operation keys return recorded receipts without replaying device commands.

hcl_remove_aclA

Remove one exact numbered/named ACL and optional IPv4 binding with backup, scope and startup readback.

Named types may be resolved from the actual config; unrelated definitions and bindings remain protected.

hcl_apply_vlan_networkC

Apply scoped VLAN/access/trunk/router subinterface changes across staged devices.

All targets and backups precede changes; persistence and recovery stay bound to each VM.

hcl_apply_aclB

Apply one strict Comware numbered or named ACL after identity, backup and restore preflight.

Changes only requested rules/bindings; readback and unrelated scope checks are mandatory.

hcl_apply_vlanB

Apply strict single-device VLAN/port/SVI intent with backup, readback and recovery.

Native trunk membership is replaced with the exact requested allowed VLAN set.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
capabilities_resourceRead the same capability boundaries exposed by hcl_capabilities.
devices_resource
ports_resource
aliases_resource
cables_resource
templates_resource

TDQS

C2.6/5.0

Scored across 55 tools

Disambiguation3/5

Many tools target distinct phases, but several clusters overlap: hcl_capabilities/hcl_backend_capabilities/hcl_parity_report/hcl_bridge_status; hcl_stage_copy/hcl_full_build/hcl_stage_plan; hcl_plan_topology/hcl_estimate_plan; and hcl_apply_vlan/hcl_apply_vlan_network. hcl_stage_add_device can also link, overlapping with hcl_stage_link. Descriptions help, but the set is large enough that an agent could easily misselect.

Naming Consistency4/5

All tool names use a consistent hcl_ prefix and snake_case, with most following a verb_noun pattern such as hcl_list_devices, hcl_stage_add_device, and hcl_apply_vlan. Minor deviations like hcl_capabilities, hcl_full_build, hcl_device_power, and hcl_console_exec are still readable and do not seriously break the pattern.

Tool Count1/5

With 55 tools, the surface is far beyond a well-scoped 3-15 range and even beyond the 25+ threshold for 'too many'. The many specialized, gated, and stage-specific operations make the server unwieldy for an agent to navigate reliably.

Completeness4/5

The tool set broadly covers planning, validation, staging CRUD, project lifecycle, config generation/export/load, backup/restore/deploy, live readback, audit, and many apply/remove operations. Some gaps remain, such as project deletion and complete live link inventory, and power-off is unsupported, but the core lifecycle is well represented.

Maintenance

ActivityMaintained
ResponsivenessNo issues