Senparc.Xncf.MCP 0.5.13

Prefix Reserved

dotnet add package Senparc.Xncf.MCP --version 0.5.13

NuGet\Install-Package Senparc.Xncf.MCP -Version 0.5.13

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="Senparc.Xncf.MCP" Version="0.5.13" />

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

<PackageVersion Include="Senparc.Xncf.MCP" Version="0.5.13" />
                    

                            Directory.Packages.props

<PackageReference Include="Senparc.Xncf.MCP" />
                    

                            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 Senparc.Xncf.MCP --version 0.5.13

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

#r "nuget: Senparc.Xncf.MCP, 0.5.13"

#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 Senparc.Xncf.MCP@0.5.13

#: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=Senparc.Xncf.MCP&version=0.5.13
                    

                            Install as a Cake Addin

#tool nuget:?package=Senparc.Xncf.MCP&version=0.5.13
                    

                            Install as a Cake Tool

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

MCP Endpoint Management

The admin page is /Admin/MCP/Index?uid=149d8021-1783-4fc9-97a8-f1a1ba60245b. It has two separate lists:

MCP servers published by this site: read-only runtime information, including the owning module, route, supported HTTP transports and copyable endpoint addresses.
Client connection configurations: saved endpoints that clients can call, with filtering, create/edit, enable/disable, delete, connection tests and tool schema inspection.

Published services are not inserted into the configuration table, so the same local service may also have an independently managed client configuration. Changing or deleting that configuration does not enable, disable or unpublish the owning module's server.

The published list joins completed NCF MCP registrations with the host's actual mapped routes. Merely setting EnableMcpServer or registering services without successfully mapping a route is not sufficient to appear. Addresses use the current request's scheme, host and deployment path base. Listing a route does not imply anonymous access or Internet reachability; permissions and tools remain controlled by the owning module.

API registration

All seven management methods in MCPEndpointAppService use explicit POST ApiBind attributes and admin API authentication. Registering the service with dependency injection alone does not publish its methods as HTTP endpoints.

The route prefix is:

/api/Senparc.Xncf.MCP/MCPEndpointAppService/Xncf.MCP_MCPEndpointAppService.

Methods: GetPublishedServers, GetAllEndpoints, GetEnabledEndpoints, SaveEndpoint, DeleteEndpoint, TestEndpoint, and TestConnection.

After updating the module, rebuild and restart the host so that the dynamic API controllers and embedded JavaScript are regenerated. If an endpoint returns HTTP 404, verify that the host has loaded the updated module. HTTP 401/403 indicates missing authentication or insufficient permissions. The UI displays these errors instead of treating unexpected responses as successful saves.

Endpoint addresses and connection tests

Supply a unique name and the complete endpoint address. Leading/trailing whitespace is removed; paths and query strings are not rewritten.
For the local NCF SSE server, use http://localhost:5080/mcp-senparc-xncf-mcp/sse with type sse.
SSE servers may use custom paths; the module does not append /sse.
Type http uses Streamable HTTP. A pre-save test without a specified type retains automatic HTTP transport detection.
stdio and websocket configurations can still be stored, but their connection tests report that the transport is unsupported.
Saving configuration does not require the remote server to be reachable.
Connection initialization and tool discovery share a 15-second default timeout. Failed tests remain visibly failed and saved tests persist their timestamp, result and tool count.
Missing names/addresses, duplicate names, invalid IDs and overlength fields return explicit failure responses.

The existing Add_MCPEndpoint migrations create the endpoint table. If the host reports a database schema upgrade requirement, use the normal NCF module/database upgrade workflow; a URL change cannot fix a missing table.

Removal of the template database example

Version 0.5.8 removes the DatabaseSample page/menu and the sample Color model, DTO, mapping, service, application service and installation-time seed data. The module keeps its real MCP endpoint configuration model and APIs.

Historical migrations are retained for already deployed databases. The cleanup migrations drop only the sample Color table and leave the MCPEndpoint table and its records intact. Use the normal NCF database upgrade workflow before serving requests with the updated model; there is no uninstall/reinstall requirement. A migration downgrade can recreate the empty sample table, but cannot recover deleted sample data.

Regression tests

Run from the repository root:

dotnet test tools/NcfSimulatedSite/Tests/Senparc.Areas.Admin.Tests/Senparc.Areas.Admin.Tests.csproj \
  --filter 'FullyQualifiedName~McpEndpointManagementTests|FullyQualifiedName~PublishedMcpServerTests|FullyQualifiedName~McpDatabaseSample'

node --test tools/NcfSimulatedSite/Tests/Senparc.Areas.Admin.Tests/Client/McpEndpointManagementTests.js

The .NET tests use isolated databases, real generated API controllers and local HTTP servers. They cover authentication, POST routing, publication discovery, deployment path bases, configuration persistence, validation, connection failures, tool/schema discovery, timeout, cancellation and the sample cleanup migration. Client tests cover the two independent lists, read-only publication display, copy actions, configuration interactions, server errors, malformed responses, duplicate submissions and tool expansion.

To additionally test the running local SSE server:

MCP_LIVE_TEST_URL=http://localhost:5080/mcp-senparc-xncf-mcp/sse \
  dotnet test tools/NcfSimulatedSite/Tests/Senparc.Areas.Admin.Tests/Senparc.Areas.Admin.Tests.csproj \
  --filter 'FullyQualifiedName~McpEndpointManagementTests'

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.Agents.AI (>= 1.28.0)
- Microsoft.Agents.AI.Abstractions (>= 1.28.0)
- Microsoft.Agents.AI.Harness (>= 1.28.0)
- Microsoft.Extensions.AI (>= 10.11.0)
- Microsoft.Extensions.AI.OpenAI (>= 10.11.0)
- Microsoft.Extensions.FileProviders.Embedded (>= 10.0.2)
- OllamaSharp (>= 5.4.25)
- OpenAI (>= 2.14.0)
- Senparc.AI (>= 0.27.4)
- Senparc.AI.AgentKernel (>= 0.1.17)
- Senparc.CO2NET.WebApi (>= 2.1.9-preview)
- Senparc.Ncf.AreaBase (>= 0.23.11)
- Senparc.Ncf.DatabasePlant (>= 0.21.15)
- Senparc.Ncf.Service (>= 0.23.12-preview11)
- Senparc.Xncf.AIKernel (>= 0.17.3)
- Senparc.Xncf.AreasBase (>= 0.13.13)
- Senparc.Xncf.MCP.Abstractions (>= 0.1.1)
- Senparc.Xncf.SenMapic (>= 0.4.12)
- System.ClientModel (>= 1.16.0)

NuGet packages (2)

Showing the top 2 NuGet packages that depend on Senparc.Xncf.MCP:

Package	Downloads
Senparc.Xncf.XncfBuilder Senparc.Xncf.XncfBuilder 快速生成 XNCF 模块基础程序代码	54.7K
Senparc.Xncf.AgentsManager Agents 管理模块	16.8K

GitHub repositories

This package is not used by any popular GitHub repositories.

Version	Downloads	Last Updated
0.5.13	76	11/11/2026
0.5.12	74	11/5/2026
0.5.11	85	11/2/2026
0.5.9	93	10/10/2026
0.5.8	87	10/4/2026
0.5.6	96	9/25/2026
0.5.5	109	9/18/2026
0.5.4	99	9/16/2026
0.5.3	95	9/15/2026
0.5.2	164	8/29/2026
0.5.1	241	8/23/2026
0.5.1-preview9	149	8/14/2026
0.5.0-preview8	136	8/12/2026
0.4.4-preview7	140	8/8/2026
0.4.3-preview6	146	8/3/2026
0.4.2-preview5	135	7/31/2026
0.4.1-preview4	124	7/28/2026
0.4.0-preview3	112	7/26/2026
0.3.3.1-preview2	100	7/15/2026
0.3.3-preview2	110	7/15/2026

[2025-06-20] v0.2.1-beta Add MCP functions in XncfRegisterBase class
     [2025-06-20] v0.2.2-beta Add MCP functions in XncfRegisterBase class
     v0.1.0 创世
     v0.2.0 Update new ModelContextProtocol library
     [2025-06-28] v0.2.3-preview.1 Add MCP server selection in MyFunction_MCPCallRequest
     [2025-11-01] update basic libraries, including Senparc.AI
     [2026-04-24] Simplify FunctionRender request parameters and keep SelectionList UI metadata compatibility
     [2026-07-02] v0.3.2-preview1 支持流式输出并优化交互体验，升级 Senparc.AI.AgentKernel 并完成兼容性适配
     1、支持流式输出并优化交互体验
     2、升级 Senparc.AI.AgentKernel 并完成兼容性适配
     [2026-07-07] v0.3.3-preview2 Dependency updates from upstream modules
     1、Dependency update from Senparc.Xncf.AIKernel to 0.13.5-preview4
     2、升级 Senparc.AI 至 0.27.3、Senparc.AI.AgentKernel 至 0.1.10
     [2026-07-16] v0.3.3.1-preview3 remove .placeholder file in wwwroot folder
     [2026-07-17] v0.4.0-preview3 为 MCP 模块接入统一资源本地化并优化功能文案
     1、接入统一资源本地化机制，支持模块功能文案按当前文化动态显示
     2、更新 FunctionRender 与请求模型文案的资源化解析
     3、统一模块注册信息、菜单名称与功能描述的本地化输出
     4、同步管理页面与前端交互文案的多语言显示
     5、同步 AIKernel 0.14.0-preview5 的 NeuChar 模型 API 版本适配
     [2026-07-29] v0.4.1-preview4 Dependency update from Senparc.Ncf.AreaBase to 0.22.0-preview3
     [2026-07-31] v0.4.2-preview5 升级 MCP 模块的 AI 与 CO2NET 兼容依赖
     1、升级 Senparc.AI 组件版本以适配 CO2NET 4.2.0 二进制接口
     2、升级 Senparc.CO2NET.WebApi 至 2.1.9-preview
     [2026-08-04] v0.4.3-preview6 Dependency updates from upstream projects
     1、Dependency update from Senparc.Ncf.AreaBase to 0.23.1-preview5
     2、Dependency update from Senparc.Ncf.DatabasePlant to 0.21.5-preview5
     3、Dependency update from Senparc.Ncf.Service to 0.23.5-preview5
     4、Dependency update from Senparc.Xncf.AIKernel to 0.15.1-preview8
     5、Dependency update from Senparc.Xncf.SenMapic to 0.4.1-preview5
     6、Dependency update from Senparc.Xncf.AreasBase to 0.13.3-preview5
     [2026-08-08] v0.4.4-preview7 Dependency updates from upstream projects
     1、Dependency update from Senparc.Ncf.AreaBase to 0.23.2-preview6
     2、Dependency update from Senparc.Ncf.DatabasePlant to 0.21.6-preview6
     3、Dependency update from Senparc.Ncf.Service to 0.23.6-preview6
     4、Dependency update from Senparc.Xncf.AIKernel to 0.15.2-preview9
     5、Dependency update from Senparc.Xncf.SenMapic to 0.4.2-preview6
     6、Dependency update from Senparc.Xncf.AreasBase to 0.13.4-preview6
     [2026-08-13] v0.5.0-preview8 补充 A2A 发布管理所需 MCP 功能与多语言资源
     1、扩展发布智能体相关 MCP 应用服务能力
     2、补齐多语言资源，保持管理端功能文案一致
     [2026-08-15] v0.5.1 Dependency update from Senparc.Xncf.AIKernel to 0.15.3-preview12
     1、Dependency update from Senparc.Xncf.AIKernel to 0.15.4
     2、更新 AIKernel 依赖，保持发布智能体相关 MCP 能力兼容
     [2026-08-29] v0.5.2 Dependency updates from Senparc.Ncf.DatabasePlant to 0.21.10; Dependency update from Senparc.Ncf.Service to 0.23.9-preview9
     1、Dependency update from Senparc.Ncf.DatabasePlant to 0.21.10
     2、Dependency update from Senparc.Ncf.Service to 0.23.9-preview9
     [2026-09-15] v0.5.3 适配 AgentKernel 与 Harness 依赖版本
     1、同步共享 AI 依赖版本和 Harness 包引用
     2、保持 MCP 工具调用与宿主模块的兼容性
     [2026-09-16] v0.5.4 Dependency updates from Senparc.Xncf.AgentsManager to 0.17.2; Senparc.Web to 0.39.1
     [2026-09-17] v0.5.5 适配共享 AgentKernel 预览依赖版本
     1、同步 Senparc.AI.AgentKernel 至 0.1.14-preview5
     2、保持 MCP 工具调用与宿主模块兼容
     [2026-09-24] v0.5.6 可视化 MCP 端点管理：配置记录、列表、连接测试与工具查看
     1、管理端提供 MCP 端点列表、新增/编辑/删除、启用开关与 Bearer Token 配置
     2、连接测试基于 Senparc.AI.AgentKernel 建立真实连接，展示可展开的 Function 工具列表、参数与 inputSchema
     3、新增 Senparc.Xncf.MCP.Abstractions 契约包，通过 EventBus 提供 QueryMcpEndpoints 请求/响应与端点变更事件
     4、MCPEndpoint 实体记录最近测试结果与工具数量，并补齐 5 个数据库提供方的 EF 迁移
     [2026-10-03] v0.5.7 修复 MCP 端点管理 API 注册、列表和保存错误提示，补齐输入校验及传输模式/超时测试
     [2026-10-04] v0.5.8 展示本站实际发布的 MCP 服务，完整移除数据库示例并提供保留端点配置的升级迁移
     [2026-10-05] v0.5.6 feat: add MCP endpoint selection feature in AgentsManager
     1、Updated Senparc.Xncf.MCP project behavior and integration for the latest feature and reliability improvements.
     [2026-10-09] v0.5.9 Dependency update from Senparc.Xncf.AIKernel to 0.16.4
     [2026-11-03] v0.5.10 MCP 函数调用接入 Token 用量记录
     1、MyFunction 对话结果写入 Token 用量
     2、适配 Senparc.AI.AgentKernel 0.1.15-preview2
     3、维护 MCP 端点管理、模块菜单与后台租户作用域
     4、Dependency update from Senparc.Xncf.MCP.Abstractions to 0.1.1
   [2026-11-03] Add shared contextual documentation beside MCP client connections.
   [2026-11-03] v0.5.12 以中文资源为基准统一整理多语言文案
   1、补齐并校正各语言资源条目，使模块界面文案与中文基准保持一致
   2、Dependency update from Senparc.Ncf.AreaBase to 0.23.10
   3、Dependency update from Senparc.Ncf.DatabasePlant to 0.21.14
   4、Dependency update from Senparc.Ncf.Service to 0.23.11-preview10
   5、Dependency update from Senparc.Xncf.AIKernel to 0.17.2
   6、Dependency update from Senparc.Xncf.SenMapic to 0.4.11
   7、Dependency update from Senparc.Xncf.AreasBase to 0.13.12
   [2026-11-11] v0.5.13 对齐 Microsoft.Extensions.AI 10.11.0 与 Agent Framework 1.28
   1、Microsoft.Extensions.AI 升级到 10.11.0，以适配 Microsoft Agent Framework 1.28。
   2、共享 AI 依赖升级到 Senparc.AI.AgentKernel 0.1.17 与 OpenAI 2.14.0。
   3、Register 通过 XncfRegisterText 用稳定资源键解析菜单名称与模块说明。