CrestApps.OrchardCore.AgentSkills.Mcp 1.0.0-beta-0010

CrestApps.OrchardCore.AgentSkills.Mcp

A runtime NuGet package that exposes Orchard Core agent skills to MCP (Model Context Protocol) servers using the MCP C# SDK.

This package loads skill files at runtime via OrchardCore's FileSystemStore and registers them as MCP prompts and resources through dedicated provider classes. It does not copy files to the solution — use the companion CrestApps.OrchardCore.AgentSkills package for local AI authoring.

Role in CrestApps.AgentSkills

CrestApps.OrchardCore.AgentSkills.Mcp is the Orchard Core runtime project in the CrestApps.AgentSkills repository. It solves the problem of exposing Orchard Core skills via MCP by loading the packaged skills and wiring them into an MCP server at runtime.

Install

dotnet add package CrestApps.OrchardCore.AgentSkills.Mcp

Usage

builder.Services.AddMcpServer(mcp =>
{
    mcp.AddOrchardCoreSkills();
});

Register Services Only (No Eager Loading)

To register the skill services in DI without eagerly loading them:

builder.Services.AddOrchardCoreAgentSkillServices();

The consumer is then responsible for resolving IMcpPromptProvider and IMcpResourceProvider and attaching them to the MCP server.

With Custom Path

builder.Services.AddMcpServer(mcp =>
{
    mcp.AddOrchardCoreSkills(options =>
    {
        options.Path = "./custom-skills";
    });
});

Resolving Providers from DI

The file store and providers are registered as singletons and can be injected:

public sealed class MyService
{
    private readonly IMcpPromptProvider _promptProvider;
    private readonly IMcpResourceProvider _resourceProvider;

    public MyService(
        IMcpPromptProvider promptProvider,
        IMcpResourceProvider resourceProvider)
    {
        _promptProvider = promptProvider;
        _resourceProvider = resourceProvider;
    }

    public async Task ListPromptsAsync()
    {
        var prompts = await _promptProvider.GetPromptsAsync();
        // ...
    }
}

Requirements

• MCP C# SDK (ModelContextProtocol NuGet package)
• OrchardCore.FileStorage.FileSystem for file access
• An MCP server host (e.g., ASP.NET Core with ModelContextProtocol.AspNetCore)

Architecture

Services

What Gets Exposed

Skills Included

The package includes all Orchard Core skills organized under the orchardcore/ directory:

How It Works

1. Skill files are packed into the NuGet package under contentFiles/any/any/.agents/skills/orchardcore/.
2. NuGet copies these files into the project output directory on restore (typically bin/<config>/.agents/skills/orchardcore/).
3. AddOrchardCoreSkills() registers IMcpResourceFileStore, IMcpPromptProvider, and IMcpResourceProvider as singletons.
4. At runtime, providers use OrchardCore FileSystemStore to read files from the output directory — results are cached after the first call.
5. MCP clients can discover and use these prompts and resources via the MCP protocol.

Companion Packages

Install both for the full experience.

License

This project is licensed under the MIT License.