▲ NexaFlowDemo — Supply Chain AI Platform MCP Version

Overview

NexaFlowDemo is a complete, runnable Visual Studio 2022 demonstration of AI Agents, Real Model Context Protocol (MCP), Retrieval-Augmented Generation (RAG), Parallel Agent Execution, Event-Driven Workflows, Multi-Tenant Support, Audit Logging, and Carrier/ERP Integration — all wired into a realistic supply chain application. The fictional company NexaFlow Logistics operates 6 SKUs, 6 suppliers, and live shipment tracking — powered by real Claude AI and real MCP protocol over JSON-RPC 2.0 / stdio.

This is the MCP Version: MCP tools are hosted in a separate NexaFlowDemo.McpServer console app and invoked via the official ModelContextProtocol v1.3.0 NuGet package. The web app spawns the McpServer as a subprocess and communicates over real JSON-RPC 2.0 stdio transport through RealMcpClientService.

Architecture

Feature Pages

MCP Tools Reference

All 9 tools are hosted in the NexaFlowDemo.McpServer project as static classes annotated with [McpServerToolType] and [McpServerTool]. The WithToolsFromAssembly() call auto-registers them all at server startup. The web app calls them through RealMcpClientService via real JSON-RPC 2.0 over stdio.

MCP HTTP bridge: GET /api/mcp/tools — list all tools via RealMcpClientService • POST /api/mcp/invoke body: {"tool":"inventory_lookup","input":{"sku":"NF-SKU-001"}}

File Map

Test Suite — 181 Tests Passing

Quick Start

Prerequisites

• .NET 9 SDK
• Visual Studio 2022 (17.8+) or VS Code with C# Dev Kit
• Anthropic API key (required — MCP Version always uses live Claude)
• No database server, no broker, no other external dependencies

Set Your API Key

# In src/NexaFlowDemo.Web/appsettings.json:
{
  "LLM": {
    "ApiKey": "sk-ant-...",
    "Model": "claude-sonnet-4-6"
  }
}

Run

cd src/NexaFlowDemo.Web
dotnet run
# → http://localhost:5xxx  (check console for port)
# The McpServer subprocess is launched automatically on first tool call — no manual start needed

Test

# Run all tests (Core + McpServer tool tests)
dotnet test src/NexaFlowDemo.Tests/NexaFlowDemo.Tests.csproj
# → Passed! Failed: 0, Passed: 181

# Run with minimal output (final verification)
dotnet test src/NexaFlowDemo.Tests/NexaFlowDemo.Tests.csproj --verbosity minimal

Demo Login Accounts

Try the Workflow Engine

# POST /api/webhooks/orders (triggers inventory_low when quantity > 50)
curl -X POST http://localhost:5xxx/api/webhooks/orders \
  -H "Content-Type: application/json" \
  -d '{"orderId":"ORD-001","customerId":"CUST-001","source":"Shopify","status":"new","totalAmount":1500,"lineItems":[{"skuId":"NF-SKU-001","quantity":100,"price":15}]}'

Enable SQLite Conversation Persistence

{
  "Persistence": {
    "UseInMemory": false,
    "ConnectionString": "Data Source=nexaflow.db"
  }
}

Then change Program.cs to register SqliteConversationStore instead of InMemoryConversationStore.

MCP API Examples

# List tools (fetched from McpServer subprocess via RealMcpClientService)
curl http://localhost:5xxx/api/mcp/tools

# ERP: Create PO
curl -X POST http://localhost:5xxx/api/mcp/invoke \
  -H "Content-Type: application/json" \
  -d '{"tool":"erp_connector","input":{"action":"create_po","supplier_id":"SUP-001","amount":"5000"}}'

# Inventory lookup
curl -X POST http://localhost:5xxx/api/mcp/invoke \
  -H "Content-Type: application/json" \
  -d '{"tool":"inventory_lookup","input":{"sku":"NF-SKU-001"}}'

Roadmap

ClaudeLiveKey → MCP_Version Migration

This project (MCP_Version) is a copy of the completed ClaudeLiveKey build with the simulated MCP layer replaced by real Model Context Protocol using the official ModelContextProtocol v1.3.0 NuGet package, JSON-RPC 2.0 over stdio transport, and a new NexaFlowDemo.McpServer subprocess.

What Changed

builder.Services.AddMcpServer()
    .WithStdioServerTransport()
    .WithToolsFromAssembly(
        Assembly.GetExecutingAssembly(), jsonOptions);
await app.RunAsync();

var transport = new StdioClientTransport(
    new StdioClientTransportOptions {
        Command = "dotnet",
        Arguments = ["exec", ResolveServerPath()],
        Name = "NexaFlowDemoMcpServer"
    });
_client = await McpClient.CreateAsync(transport, ct);

builder.Services.AddSingleton<IMcpServerService,
    RealMcpClientService>();

[McpServerToolType]
public static class InventoryTools
{
    [McpServerTool(Name = "inventory_lookup", ReadOnly = true)]
    [Description("Look up stock level for a SKU.")]
    public static string LookupInventory(
        [Description("The product SKU code")] string sku)
    { … }
}

"McpServer": {
  "ServerPath": ""  // auto-detected if blank
}

What Did NOT Change

• All 154 Core unit tests — no changes; they test Core library components, not MCP transport.
• SimulatedLlmService — kept in Core library; still used by agent unit tests.
• Embeddings — remain simulated (SimulatedDenseEmbeddingService); Anthropic embedding API not required for this demo.
• All workflows, memory, multi-tenant, audit, carrier services — all simulated, no external calls.
• All Razor views and controllers — unchanged; they use IMcpServerService which the new RealMcpClientService implements.
• ClaudeService — unchanged; the MCP Version was already using the live Claude API.

How to Set Your API Key

Get your key from console.anthropic.com → API Keys, then set it in one of these ways:

Bug Fixes & API Gotchas (MCP Version)

🐞 BF-001 — StdioClientTransportOptions Has No Version Property

// WRONG:
new StdioClientTransportOptions {
    Command = "dotnet",
    Arguments = ["exec", path],
    Name = "NexaFlowDemoMcpServer",
    Version = "1.0"   // ← does not exist
}

// CORRECT:
new StdioClientTransportOptions {
    Command = "dotnet",
    Arguments = ["exec", path],
    Name = "NexaFlowDemoMcpServer"
}

🐞 BF-002 — McpClientTool.JsonSchema Not InputSchema

// WRONG:
var schema = tool.InputSchema;

// CORRECT:
var schema = tool.JsonSchema;

🐞 BF-003 — ListToolsAsync Returns a List Directly (No .Tools Wrapper)

// WRONG:
var response = await _client!.ListToolsAsync(ct);
foreach (var tool in response.Tools) { … }

// CORRECT:
var tools = await _client!.ListToolsAsync(ct);
foreach (var tool in tools) { … }

🐞 BF-004 — McpServer Must Suppress Stdout Logging

builder.Logging.ClearProviders();
builder.Logging.AddConsole(opts =>
{
    opts.LogToStandardErrorThreshold = LogLevel.Trace;
});

CLI Build Reference

All commands below run from the solution root C:\Guy\Notes\Claud Projects\Agentic Baiic 03_SupplyChain_ClaudeLiveKey_MCP_Version\. This is a 4-project solution — restore and build all four projects.

Restore Dependencies

dotnet restore src/NexaFlowDemo.Core/NexaFlowDemo.Core.csproj
dotnet restore src/NexaFlowDemo.McpServer/NexaFlowDemo.McpServer.csproj
dotnet restore src/NexaFlowDemo.Web/NexaFlowDemo.Web.csproj
dotnet restore src/NexaFlowDemo.Tests/NexaFlowDemo.Tests.csproj

Build Individual Projects

# Build the core library only
dotnet build src/NexaFlowDemo.Core/NexaFlowDemo.Core.csproj

# Build the McpServer project (also rebuilds Core)
dotnet build src/NexaFlowDemo.McpServer/NexaFlowDemo.McpServer.csproj

# Build the web app (also rebuilds Core; McpServer built separately)
dotnet build src/NexaFlowDemo.Web/NexaFlowDemo.Web.csproj

# Build the test project (rebuilds Core and McpServer as dependencies)
dotnet build src/NexaFlowDemo.Tests/NexaFlowDemo.Tests.csproj

Run Tests

# Build + run all tests (Core tests + McpServer tool tests = 181)
dotnet test src/NexaFlowDemo.Tests/NexaFlowDemo.Tests.csproj

# Run with minimal output (used for final verification)
dotnet test src/NexaFlowDemo.Tests/NexaFlowDemo.Tests.csproj --verbosity minimal

# Run without rebuilding (re-run against already-compiled binaries)
dotnet test src/NexaFlowDemo.Tests/NexaFlowDemo.Tests.csproj --no-build

Run the Web App

# Start the web application
dotnet run --project src/NexaFlowDemo.Web/NexaFlowDemo.Web.csproj
# → http://localhost:5xxx  (check console for port)
# → McpServer subprocess is spawned automatically on first tool call

Inspect Project Files

# List all .cs files in a project (PowerShell)
Get-ChildItem "src/NexaFlowDemo.Core" -Recurse -Filter "*.cs" `
  | Select-Object -ExpandProperty FullName | Sort-Object

Get-ChildItem "src/NexaFlowDemo.McpServer" -Recurse -Filter "*.cs" `
  | Select-Object -ExpandProperty FullName | Sort-Object

Get-ChildItem "src/NexaFlowDemo.Web" -Recurse -Filter "*.cs" `
  | Select-Object -ExpandProperty FullName | Sort-Object

Get-ChildItem "src/NexaFlowDemo.Tests" -Recurse -Filter "*.cs" `
  | Select-Object -ExpandProperty FullName | Sort-Object

Build Sequence Used During Development

NuGet Packages Added (MCP Version — beyond ClaudeLiveKey)

All packages from ClaudeLiveKey (Microsoft.Data.Sqlite, Microsoft.CodeAnalysis.CSharp.Scripting, Moq, xunit, etc.) are unchanged.