com.IvanMurzak.McpPlugin.Server 8.25.0

dotnet add package com.IvanMurzak.McpPlugin.Server --version 8.25.0
                    
NuGet\Install-Package com.IvanMurzak.McpPlugin.Server -Version 8.25.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="com.IvanMurzak.McpPlugin.Server" Version="8.25.0" />
                    
For projects that support PackageReference, copy this XML node into the project file to reference the package.
<PackageVersion Include="com.IvanMurzak.McpPlugin.Server" Version="8.25.0" />
                    
Directory.Packages.props
<PackageReference Include="com.IvanMurzak.McpPlugin.Server" />
                    
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 com.IvanMurzak.McpPlugin.Server --version 8.25.0
                    
#r "nuget: com.IvanMurzak.McpPlugin.Server, 8.25.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 com.IvanMurzak.McpPlugin.Server@8.25.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=com.IvanMurzak.McpPlugin.Server&version=8.25.0
                    
Install as a Cake Addin
#tool nuget:?package=com.IvanMurzak.McpPlugin.Server&version=8.25.0
                    
Install as a Cake Tool

MCP Plugin for .NET: a running .NET app connects to McpPlugin.Server over SignalR, and AI agents reach it over MCP

NuGet Server release

.NET Discord License Stand with Ukraine

MCP Plugin for .NET lets a .NET application that is already running (a game editor, a game, a desktop or server app) expose its methods as Model Context Protocol tools, prompts and resources. Usual MCP servers are started by the AI client as a subprocess; this one splits the work in two: a small library inside your app, and a bridge server that the AI client talks to. The app connects to the bridge over SignalR and keeps working on its own lifecycle. It powers Unity-MCP.

Architecture: .NET apps with McpPlugin connect to McpPlugin.Server over SignalR; AI agents and scripts reach the server over MCP (stdio or streamable HTTP) and REST

Packages

All three share one version and are released together.

Package Targets Use it in
com.IvanMurzak.McpPlugin netstandard2.1, net8.0, net9.0, net10.0 Your app: declares tools, prompts and resources and connects to the server
com.IvanMurzak.McpPlugin.Server net8.0, net9.0, net10.0 The bridge: an ASP.NET Core host for the SignalR hub and the MCP endpoints
com.IvanMurzak.McpPlugin.Common netstandard2.1 Shared models and settings; referenced by the other two

Features

✅ Attributes — [AiTool], [AiPrompt], [AiResource] on plain C# methods
✅ Any .NET type — ReflectorNet builds schemas and binds nested objects, lists, enums
✅ Lives with your app — SignalR link with auto-reconnect; catalog kept during reloads
✅ Two MCP transports — stdio or streamable HTTP on /mcp
✅ REST — GET /api/tools and POST /api/tools/{name} for scripts and tests
✅ Editor and game — editor and runtime connections side by side
✅ Tool annotations — title plus read-only, destructive, idempotent, open-world hints
✅ Skill files — a SKILL.md per tool in a SKILLS/ folder
✅ Auth and hooks — none / token / oauth modes, analytics and auth webhooks

Install

dotnet add package com.IvanMurzak.McpPlugin          # in your app
dotnet add package com.IvanMurzak.McpPlugin.Server   # in the bridge host (or run DemoWebApp)

Quick start

1. Declare tools, prompts and resources. A class is scanned only when it carries the matching [Ai*Type] attribute. [Description] text is what the AI agent reads.

using System.ComponentModel;
using com.IvanMurzak.McpPlugin;
using com.IvanMurzak.McpPlugin.Common.Model;

[AiToolType]
public static class GameTools
{
    [AiTool("add", "Add numbers", ReadOnlyHint = true)]   // name, title
    [Description("Adds two numbers.")]
    public static int Add(
        [Description("First number.")] int a,
        [Description("Second number.")] int b) => a + b;
}

[AiPromptType]
public static class GamePrompts
{
    [AiPrompt(Name = "review-scene")]
    [Description("Asks the agent to review the open scene.")]
    public static string ReviewScene(string focus = "performance")
        => $"Review the open scene. Focus on {focus}.";
}

[AiResourceType]
public static class GameResources
{
    [AiResource(Route = "app://status", Name = "app-status", MimeType = "text/plain",
        ListResources = nameof(ListStatus))]
    [Description("Current application status.")]
    public static ResponseResourceContent[] GetStatus(string uri)
        => new[] { ResponseResourceContent.CreateText(uri, "Running", "text/plain") };

    public static ResponseListResource[] ListStatus()
        => new[] { new ResponseListResource("app://status", "app-status") };
}

2. Build the plugin and connect it.

using System;
using com.IvanMurzak.McpPlugin;
using com.IvanMurzak.McpPlugin.Common;
using com.IvanMurzak.ReflectorNet;
using Version = com.IvanMurzak.McpPlugin.Common.Version;

var version = new Version { Api = Consts.ApiVersion, Plugin = "1.0.0", Environment = "MyApp" };
var assembly = typeof(GameTools).Assembly;

var plugin = new McpPluginBuilder(version)
    .WithConfig(config =>
    {
        config.Host = "http://localhost:8080";                  // the McpPlugin.Server address
        config.ProjectRootPath = Environment.CurrentDirectory;  // where SKILLS/ is written
    })
    .WithToolsFromAssembly(assembly)
    .WithPromptsFromAssembly(assembly)
    .WithResourcesFromAssembly(assembly)
    .Build(new Reflector());

await plugin.Connect(); // reconnects on its own while KeepConnected is true (the default)

Api must match the server's API version, so pass Consts.ApiVersion from the package you reference.

3. Run the server. Use the demo host from this repository:

cd DemoWebApp
dotnet run -- port=8080 client-transport=streamableHttp

or host it in your own ASP.NET Core app:

using com.IvanMurzak.McpPlugin.Common.Utils;
using com.IvanMurzak.McpPlugin.Server;
using Microsoft.AspNetCore.Builder;

var dataArguments = new DataArguments(args); // port=, client-transport=, auth=, ...

var builder = WebApplication.CreateBuilder(args);
builder.Services
    .WithMcpServer(dataArguments)
    .WithMcpPluginServer(dataArguments);
builder.WebHost.UseKestrelForMcpPlugin(dataArguments.Port, dataArguments.Bind);

var app = builder.Build();
app.UseMcpPluginServer(dataArguments);
app.Run();

4. Connect an AI agent. Point an MCP client at http://localhost:8080/mcp, or let it launch the server with client-transport=stdio. Scripts can call a tool directly:

curl -X POST http://localhost:8080/api/tools/add -H "Content-Type: application/json" -d '{"a":2,"b":3}'
# {"status":"success","structured":{"result":5}}

Writing good tools

  • Annotate. Give each tool a Title and an explicit ReadOnlyHint or DestructiveHint; MCP tool directories reject tools without them. AiToolAnnotationsValidator.Validate(assembly) lists the gaps in a unit test.
  • Fail clearly. Throw an exception with a message the agent can act on, or return ResponseCallTool.Error(message). Throw ToolUnavailableException while the host is busy (compiling, reloading). How each case is reported: docs/tool-errors.md.
  • Game-only tools. Mark them [AiToolType(Target = ToolTarget.Runtime)] and set config.ClientRole = ClientRole.Runtime in the game build, before Build().

Documentation

Page What is in it
Configuration Server arguments and environment variables, plugin settings, webhooks, Docker
Tool errors How tool failures map to MCP results and HTTP status, by version
Transport and auth stdio / streamable HTTP and the none / token / oauth modes in depth
Migrating to 8.0.0 The CancellationToken change in the prompt and resource hubs
NullEngine An engine-free test host with a fixed tool set
Chain fixtures Recording and replaying a plugin's catalog for downstream tests

The legacy [McpPluginTool], [McpPluginPrompt], [McpPluginResource] names still compile as [Obsolete] aliases of the [Ai*] attributes.

Build from source

dotnet build McpPlugin.sln
dotnet test

Runnable samples: DemoWebApp (server) and DemoConsoleApp (plugin with one tool).

Community

Questions and ideas: Discord or GitHub issues.

License

Apache-2.0 © Ivan Murzak

Product 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. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories (1)

Showing the top 1 popular GitHub repositories that depend on com.IvanMurzak.McpPlugin.Server:

Repository Stars
IvanMurzak/Unity-MCP
AI Skills, MCP Tools, and CLI for Unity Engine. Full AI develop and test loop. Use cli for quick setup. Efficient token usage, advanced tools. Any C# method may be turned into a tool by a single line. Works with Claude Code, Gemini, Copilot, Cursor and any other absolutely for free.
Version Downloads Last Updated
8.25.0 77 11/19/2026
8.24.0 128 11/14/2026
8.23.1 117 11/14/2026
8.23.0 136 11/12/2026
8.22.2 134 11/12/2026
8.22.1 112 11/11/2026
8.22.0 92 11/11/2026
8.21.0 138 11/9/2026
8.20.0 129 11/8/2026
8.19.2 109 11/8/2026
8.19.1 110 11/7/2026
8.19.0 122 11/5/2026
8.18.0 93 11/3/2026
8.17.0 96 11/3/2026
8.16.0 113 10/31/2026
8.15.0 146 10/31/2026
8.14.0 127 10/30/2026
8.13.1 127 10/23/2026
8.13.0 123 10/23/2026
8.12.0 116 10/22/2026
Loading failed