OPCFoundation.NetStandard.Opc.Ua.Mcp.CranesHoists
2.0.2-preview.300
Prefix Reserved
dotnet add package OPCFoundation.NetStandard.Opc.Ua.Mcp.CranesHoists --version 2.0.2-preview.300
NuGet\Install-Package OPCFoundation.NetStandard.Opc.Ua.Mcp.CranesHoists -Version 2.0.2-preview.300
<PackageReference Include="OPCFoundation.NetStandard.Opc.Ua.Mcp.CranesHoists" Version="2.0.2-preview.300" />
<PackageVersion Include="OPCFoundation.NetStandard.Opc.Ua.Mcp.CranesHoists" Version="2.0.2-preview.300" />
<PackageReference Include="OPCFoundation.NetStandard.Opc.Ua.Mcp.CranesHoists" />
paket add OPCFoundation.NetStandard.Opc.Ua.Mcp.CranesHoists --version 2.0.2-preview.300
#r "nuget: OPCFoundation.NetStandard.Opc.Ua.Mcp.CranesHoists, 2.0.2-preview.300"
#:package OPCFoundation.NetStandard.Opc.Ua.Mcp.CranesHoists@2.0.2-preview.300
#addin nuget:?package=OPCFoundation.NetStandard.Opc.Ua.Mcp.CranesHoists&version=2.0.2-preview.300&prerelease
#tool nuget:?package=OPCFoundation.NetStandard.Opc.Ua.Mcp.CranesHoists&version=2.0.2-preview.300&prerelease
OPC UA Cranes and Hoists MCP tools (preview)
Bounded OPC 40020-1 workflows over CranesHoistsClient. This package and its
Debug variant are preview-only. It uses the host's existing OPC UA session
manager; it does not implement a separate protocol or subscription engine.
services.AddOpcUaMcpCore();
services.AddOpcUaMcpCranesHoists();
services.AddMcpServer()
.WithStdioServerTransport()
.WithOpcUaMcpFilters()
.WithOpcUaCranesHoistsTools(McpToolProfile.CranesHoists);
WithOpcUaCranesHoistsTools also accepts a McpToolProfileSet for composition.
Full selects all crane tools. Other profiles contribute nothing. Shared
connection tools are registered at most once, even in composed catalogs.
Register CranesHoistsClientOptions before the accessor to customize bounded
topology discovery, and TimeProvider to customize the observation clock.
Direct construction with new CranesHoistsClientAccessor(sessionManager)
uses the same typed workflows and borrows, rather than owns, the session.
| Tool | Workflow |
|---|---|
craneshoists_list_systems |
Subtype-aware discovery from DeviceSet or a supplied organizer, including Machines |
craneshoists_read_system |
System/device/axis/load/motor/brake/protection snapshots and actual capabilities |
craneshoists_read_element |
Focused snapshot, nameplate, axis metadata and native relationships |
craneshoists_observe_values |
One bounded observation of 1–64 distinct signal NodeIds |
craneshoists_observe_events |
One bounded observation of an event-enabled system or server notifier |
craneshoists_configure_limit |
One explicitly authorized standard limit-configuration request |
Present signals include their actual NodeId, current-user write access and a
native UA JSON reading.DataValue, retaining wire types, quality and source/server
timestamps. Decode it with the stack's JsonDecoder.ReadDataValue("DataValue").
present=false means a selected optional field is absent; it is not a failed
read. Service/access failures return an MCP error with the original UA status.
Snapshots keep actual vendor subtype identities and forward ProtectsAxis or
physical-component references. Namespace presence alone is not a capability claim.
Requests and replies are bounded. Discovery defaults to 50 systems (maximum
100); the typed client also limits visited objects and browse pages. Observations
default to 5 seconds and 50 notifications, with ceilings of 60 seconds,
100 notifications and 1 MiB decoded payload/serialized JSON. Serialized replies
are bounded separately, including metadata. Overflow fails instead of returning
partial success. Observations expose the completion reason and dropped count,
preserve event IDs and qualified field order, and release only their own
subscription, including on error and cancellation.
The server honors standard MCP cancellation notifications; a client must send
the notification, not merely abandon its local wait. Direct embedding calls
also honor their CancellationToken.
Explicit configuration, not motion control
craneshoists_configure_limit is marked device-changing and non-idempotent.
It requires confirmConfiguration=true for each call and still requires the
connected caller's server-side authorization and provider acceptance. Exact
selectors are:
SpeedLimitDirMinusSetpoint,SpeedLimitDirPlusSetpoint: finite JSON numbers, inclusive range 0–100, sent as UA Double.SpeedLimitEnabledDirMinus,SpeedLimitEnabledDirPlus: JSON Booleans on an axis.SpeedLimitGlobalEnabled: a JSON Boolean on a system.
For example, a call with elementNodeId from an axis snapshot,
signal="SpeedLimitDirPlusSetpoint", value=25.0 and
confirmConfiguration=true submits only that standard request property.
requestAccepted=true is not proof that an active limit or hardware changed;
the response explicitly reports activeValueVerified=false. Re-read the axis's
separate SpeedLimitDirPlus signal to inspect the provider-reported active value.
No implicit retries, motion methods, control takeover or safety bypass exist.
If a configuration call is canceled or disconnected after submission, its
outcome may be unknown: inspect request and active values rather than retrying
automatically.
Discovery and observations never configure limits, refresh/acknowledge/confirm
conditions or initiate equipment effects.
| Product | Versions Compatible and additional computed target framework versions. |
|---|---|
| .NET | net8.0 is compatible. net8.0-android was computed. net8.0-browser was computed. net8.0-ios was computed. net8.0-maccatalyst was computed. net8.0-macos was computed. net8.0-tvos was computed. net8.0-windows was computed. net9.0 is compatible. net9.0-android was computed. net9.0-browser was computed. net9.0-ios was computed. net9.0-maccatalyst was computed. net9.0-macos was computed. net9.0-tvos was computed. net9.0-windows was computed. net10.0 is compatible. net10.0-android was computed. net10.0-browser was computed. net10.0-ios was computed. net10.0-maccatalyst was computed. net10.0-macos was computed. net10.0-tvos was computed. net10.0-windows was computed. |
-
net10.0
- BitFaster.Caching (>= 2.6.1)
- Microsoft.Bcl.TimeProvider (>= 10.0.13)
- Microsoft.Extensions.Caching.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Compliance.Abstractions (>= 10.11.0)
- Microsoft.Extensions.Configuration (>= 10.0.13)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Diagnostics (>= 10.0.13)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Http (>= 10.0.13)
- Microsoft.Extensions.Http.Resilience (>= 10.11.0)
- Microsoft.Extensions.Logging (>= 10.0.13)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Options (>= 10.0.13)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.13)
- Microsoft.Extensions.Telemetry (>= 10.11.0)
- Microsoft.Extensions.Telemetry.Abstractions (>= 10.11.0)
- ModelContextProtocol (>= 2.2.0)
- ModelContextProtocol.Core (>= 2.2.0)
- OPCFoundation.NetStandard.Opc.Ua.CranesHoists.Client (>= 2.0.2-preview.300)
- OPCFoundation.NetStandard.Opc.Ua.Mcp.Core (>= 2.0.2)
- System.Threading.RateLimiting (>= 10.0.13)
-
net8.0
- BitFaster.Caching (>= 2.6.1)
- Microsoft.Bcl.TimeProvider (>= 10.0.13)
- Microsoft.Extensions.Caching.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Compliance.Abstractions (>= 10.11.0)
- Microsoft.Extensions.Configuration (>= 10.0.13)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Diagnostics (>= 10.0.13)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Http (>= 10.0.13)
- Microsoft.Extensions.Http.Resilience (>= 10.11.0)
- Microsoft.Extensions.Logging (>= 10.0.13)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Options (>= 10.0.13)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.13)
- Microsoft.Extensions.Telemetry (>= 10.11.0)
- Microsoft.Extensions.Telemetry.Abstractions (>= 10.11.0)
- ModelContextProtocol (>= 2.2.0)
- ModelContextProtocol.Core (>= 2.2.0)
- OPCFoundation.NetStandard.Opc.Ua.CranesHoists.Client (>= 2.0.2-preview.300)
- OPCFoundation.NetStandard.Opc.Ua.Mcp.Core (>= 2.0.2)
- System.Collections.Immutable (>= 9.0.0)
- System.Diagnostics.DiagnosticSource (>= 10.0.13)
- System.Formats.Asn1 (>= 10.0.13)
- System.Text.Json (>= 10.0.13)
- System.Threading.Channels (>= 10.0.13)
- System.Threading.RateLimiting (>= 10.0.13)
-
net9.0
- BitFaster.Caching (>= 2.6.1)
- Microsoft.Bcl.TimeProvider (>= 10.0.13)
- Microsoft.Extensions.Caching.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Compliance.Abstractions (>= 10.11.0)
- Microsoft.Extensions.Configuration (>= 10.0.13)
- Microsoft.Extensions.Configuration.Abstractions (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection (>= 10.0.13)
- Microsoft.Extensions.DependencyInjection.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Diagnostics (>= 10.0.13)
- Microsoft.Extensions.Hosting.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Http (>= 10.0.13)
- Microsoft.Extensions.Http.Resilience (>= 10.11.0)
- Microsoft.Extensions.Logging (>= 10.0.13)
- Microsoft.Extensions.Logging.Abstractions (>= 10.0.13)
- Microsoft.Extensions.Options (>= 10.0.13)
- Microsoft.Extensions.Options.ConfigurationExtensions (>= 10.0.13)
- Microsoft.Extensions.Telemetry (>= 10.11.0)
- Microsoft.Extensions.Telemetry.Abstractions (>= 10.11.0)
- ModelContextProtocol (>= 2.2.0)
- ModelContextProtocol.Core (>= 2.2.0)
- OPCFoundation.NetStandard.Opc.Ua.CranesHoists.Client (>= 2.0.2-preview.300)
- OPCFoundation.NetStandard.Opc.Ua.Mcp.Core (>= 2.0.2)
- System.Diagnostics.DiagnosticSource (>= 10.0.13)
- System.Formats.Asn1 (>= 10.0.13)
- System.Text.Json (>= 10.0.13)
- System.Threading.Channels (>= 10.0.13)
- System.Threading.RateLimiting (>= 10.0.13)
NuGet packages
This package is not used by any NuGet packages.
GitHub repositories
This package is not used by any popular GitHub repositories.
| Version | Downloads | Last Updated |
|---|---|---|
| 2.0.2-preview.300 | 60 | 11/11/2026 |