LabAcacia.McpIngress 1.0.0-alpha.16

English | 中文版

LabAcacia.McpIngress

An ASP.NET Core library that turns one or more NPS NWP nodes into a single Model Context Protocol (MCP) server. MCP-speaking clients — Claude Desktop, IDE agents, the Anthropic SDK — can read from NWP Memory Nodes and invoke NWP Action Nodes without knowing anything about NPS.

• Protocol: JSON-RPC 2.0 over HTTP POST (MCP 2024-11-05).
• Target: .NET 10, ASP.NET Core.
• NWP spec: spec/NPS-2-NWP.md v0.14 (Memory Node §5, Action Node §7).

What it does

Addressing conventions:

• Resource URIs: nwp://<upstream-name>/
• Tool names: <upstream-name>__<action-id-with-dots-replaced-by-underscores>
  • Dots are forbidden in MCP tool names, so orders.create on upstream orders becomes orders__orders_create.

Install

dotnet add package LabAcacia.McpIngress

Quick start

using LabAcacia.NPS.McpIngress;

var builder = WebApplication.CreateBuilder(args);

builder.Services.AddMcpIngress(o =>
{
    o.ServerName    = "my-agent-gateway";
    o.ServerVersion = "1.0.0";
    o.Upstreams     = new[]
    {
        new NwpUpstream
        {
            Name       = "products",
            BaseUrl    = new Uri("https://memory.example.com/products"),
            AgentNid   = "urn:nps:nid:agent:my-gateway",
            AuthHeader = "Bearer <service-token>",
        },
        new NwpUpstream
        {
            Name    = "orders",
            BaseUrl = new Uri("https://action.example.com/orders"),
        },
    };
});

var app = builder.Build();
app.MapMcpIngress("/mcp");   // POST /mcp — JSON-RPC 2.0
app.Run();

Point any MCP client at https://<host>/mcp. No agent code needs to be changed.

Configuration

McpIngressOptions:

NwpUpstream:

Error mapping

Errors are returned as JSON-RPC 2.0 errors. In addition to the standard codes (-32700 parse, -32600 invalid request, -32601 method not found, -32602 invalid params, -32603 internal), the ingress defines:

JSON-RPC notifications (requests without id) receive HTTP 204 No Content per the spec.

Testing

dotnet test tests/LabAcacia.McpIngress.Tests/LabAcacia.McpIngress.Tests.csproj

The test suite exercises every MCP handler against a fake NWP backend (HttpMessageHandler stubs) — no network required.

Further reading

• MCP Ingress deep dive — 1:N model, tool-name encoding, async lifecycle, header semantics, production notes
• Compat ingresses overview — when to pick MCP / A2A / gRPC

License

Apache 2.0. See LICENSE and NOTICE at the repo root.