47e6a6412e* Convert records to classes * Make properties in SseClientTransportOptions settable. * Convert missing property from init to set
72 lines
2.7 KiB
C#
72 lines
2.7 KiB
C#
namespace ModelContextProtocol.Client;
|
|
|
|
/// <summary>
|
|
/// Provides options for configuring <see cref="StdioClientTransport"/> instances.
|
|
/// </summary>
|
|
public class StdioClientTransportOptions
|
|
{
|
|
/// <summary>
|
|
/// Gets or sets the command to execute to start the server process.
|
|
/// </summary>
|
|
public required string Command
|
|
{
|
|
get;
|
|
set
|
|
{
|
|
if (string.IsNullOrWhiteSpace(value))
|
|
{
|
|
throw new ArgumentException("Command cannot be null or empty.", nameof(value));
|
|
}
|
|
|
|
field = value;
|
|
}
|
|
}
|
|
|
|
/// <summary>
|
|
/// Gets or sets the arguments to pass to the server process when it is started.
|
|
/// </summary>
|
|
public IList<string>? Arguments { get; set; }
|
|
|
|
/// <summary>
|
|
/// Gets or sets a transport identifier used for logging purposes.
|
|
/// </summary>
|
|
public string? Name { get; set; }
|
|
|
|
/// <summary>
|
|
/// Gets or sets the working directory for the server process.
|
|
/// </summary>
|
|
public string? WorkingDirectory { get; set; }
|
|
|
|
/// <summary>
|
|
/// Gets or sets environment variables to set for the server process.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// <para>
|
|
/// This property allows you to specify environment variables that will be set in the server process's
|
|
/// environment. This is useful for passing configuration, authentication information, or runtime flags
|
|
/// to the server without modifying its code.
|
|
/// </para>
|
|
/// <para>
|
|
/// By default, when starting the server process, the server process will inherit the current environment's variables,
|
|
/// as discovered via <see cref="Environment.GetEnvironmentVariables()"/>. After those variables are found, the entries
|
|
/// in this <see cref="EnvironmentVariables"/> dictionary are used to augment and overwrite the entries read from the environment.
|
|
/// That includes removing the variables for any of this collection's entries with a null value.
|
|
/// </para>
|
|
/// </remarks>
|
|
public Dictionary<string, string?>? EnvironmentVariables { get; set; }
|
|
|
|
/// <summary>
|
|
/// Gets or sets the timeout to wait for the server to shut down gracefully.
|
|
/// </summary>
|
|
/// <remarks>
|
|
/// <para>
|
|
/// This property dictates how long the client should wait for the server process to exit cleanly during shutdown
|
|
/// before forcibly terminating it. This balances between giving the server enough time to clean up
|
|
/// resources and not hanging indefinitely if a server process becomes unresponsive.
|
|
/// </para>
|
|
/// <para>
|
|
/// The default is five seconds.
|
|
/// </para>
|
|
/// </remarks>
|
|
public TimeSpan ShutdownTimeout { get; set; } = TimeSpan.FromSeconds(5);
|
|
}
|