Native.Mcp.Testing 2.1.0

.NET 10.0

dotnet add package Native.Mcp.Testing --version 2.1.0

NuGet\Install-Package Native.Mcp.Testing -Version 2.1.0

This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.

<PackageReference Include="Native.Mcp.Testing" Version="2.1.0" />

For projects that support PackageReference, copy this XML node into the project file to reference the package.

<PackageVersion Include="Native.Mcp.Testing" Version="2.1.0" />
                    

                            Directory.Packages.props

<PackageReference Include="Native.Mcp.Testing" />
                    

                            Project file

For projects that support Central Package Management (CPM), copy this XML node into the solution Directory.Packages.props file to version the package.

paket add Native.Mcp.Testing --version 2.1.0

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

#r "nuget: Native.Mcp.Testing, 2.1.0"

#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.

#:package Native.Mcp.Testing@2.1.0

#:package directive can be used in C# file-based apps starting in .NET 10 preview 4. Copy this into a .cs file before any lines of code to reference the package.

#addin nuget:?package=Native.Mcp.Testing&version=2.1.0
                    

                            Install as a Cake Addin

#tool nuget:?package=Native.Mcp.Testing&version=2.1.0
                    

                            Install as a Cake Tool

The NuGet Team does not provide support for this client. Please contact its maintainers for support.

Native.Mcp.Testing

Test helpers for Native.Mcp: an in-memory MCP host, a JSON-RPC test client (no HTTP/Lambda), fluent builders and Shouldly assertion helpers.

This library is reflection-based on purpose and is not AOT-constrained — it is test infrastructure.

Quickstart

await using var host = McpTestHost.CreateBuilder()
    .WithServerInfo("my-mcp", "1.0.0")
    .AddTool<PingTool>()                                  // input/output inferred via reflection
    .ConfigureServices(s => s.AddSingleton<INativeValidator<EchoInput>, EchoInputValidator>())
    .Build();

var client = host.CreateClient();

var response = await client.CallToolAsync("ping", new { }, new McpRequestOptions
{
    CorrelationId = "test-001",
    Roles = ["sample-ping"],
});

response.ShouldBeSuccessful();
response.Envelope!.DataAs<PingOutput>()!.Status.ShouldBe("ok");

Components

McpTestHost / McpTestHostBuilder — real DI container + dispatcher, no transport. WithMetrics / WithToolLogger / WithTimeProvider let you capture telemetry or pin time.
McpTestClient — InitializeAsync, ListToolsAsync, CallToolAsync, SendRawAsync.
Builders — McpExecutionContextBuilder (for unit-testing a tool directly), McpRequestBuilder, McpEnvelopeBuilder.
Assertions (Shouldly extensions) — result.ShouldBeSuccess() / result.ShouldBeFailure().ShouldHaveProblemType(...) on McpToolResult<T>; response.ShouldBeSuccessful() / response.ShouldBeError().ShouldHaveProblemType(...) / response.ShouldBeProtocolError(code) on McpToolCallResponse.

Unit-testing a tool directly

var ctx = new McpExecutionContextBuilder().WithRole("sample-ping").Build();
var result = await new PingTool().ExecuteAsync(new PingInput(), ctx, default);
result.ShouldBeSuccess();

License

MIT.

Product	Compatible and additional computed target framework versions.
.NET	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.

Compatible target framework(s)

Included target framework(s) (in package)

Learn more about Target Frameworks and .NET Standard.

net10.0
- Microsoft.Extensions.DependencyInjection (>= 10.0.8)
- Native.Mcp (>= 2.1.0)
- Shouldly (>= 4.3.0)

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.1.0	0	6/5/2026
2.0.0	38	6/5/2026
1.0.0	35	6/4/2026