Xperience Community MCP Server

Xperience Community MCP 服务

描述

警告

此软件包已弃用。请改用以下原生 Xperience by Kentico AI 功能：

• 内容类型管理 API + MCP 服务
• 文档 MCP 服务
• 内容建模 MCP 服务

这是一个使用 .NET MCP Server SDK 构建、专为 Xperience by Kentico 项目定制并以 NuGet 软件包形式安装的 MCP 服务。

为什么要使用此库？通过向 Xperience by Kentico 项目中的AI Agent提供一组明确记录的工具，该 Agent 可以获得结构更完善的上下文和能力。这意味着，它可以更好地协助开发者使用 Xperience by Kentico 为营销人员构建功能。

如需详细了解此项目，请阅读博文 将 Xperience by Kentico 应用程序转变为 MCP 服务。

截图

要求

库版本对照表

Xperience 版本	库版本
>= 30.6.1	2.0.x
>= 30.4.1	1.0.0

依赖项

• ASP.NET Core 8.0
• Xperience by Kentico

其他要求

• 2025 年 4 月最新发布版本的 VS Code（v1.100）或更高版本，支持使用 HTTP 流式传输的 MCP 服务。

软件包安装

使用 .NET CLI 将软件包添加到应用程序中

dotnet add package XperienceCommunity.MCPServer

快速入门

1. 安装软件包后，更新 Xperience by Kentico 应用的 Program.cs

   // Program.cs
   
   // ...
   
   // Adds the MCP dependencies
   if (builder.Environment.IsDevelopment())
   {
       builder.Services.AddXperienceMCPServer();
   }
   
   // ...
   
   // Adds the MCP endpoint
   if (builder.Environment.IsDevelopment())
   {
       app.UseXperienceMCPServer();
   }
   
   app.Kentico().MapRoutes();
   
   // ...
   

2. 启动 Xperience by Kentico 应用。

3. 按照在 VS Code 中配置 MCP 服务进行设置

   {
     "servers": {
       "xperience-mcp-server": {
         "type": "http",
         "url": "http://localhost:<your-port-here>/xperience-mcp"
       }
     }
   }
   

   你可以参考 .vscode/mcp.json 配置示例。方案、域名和端口来自 examples/DancingGoat/Properties/launchSettings.json 文件，因为 DancingGoat Xperience by Kentico 应用也会运行 MCP 服务。默认的 MCP 服务路径前缀为 /xperience-mcp。

   你可以使用 VS Code 命令面板管理并启动 MCP 服务，也可以点击 mcp.json 中服务器配置上方的“Start”操作。

   注意：VS Code 的 MCP 客户端尚不支持自签名证书，因此，如果你一直在 Xperience 应用中使用 https:// 和 dev-certs，则需要在 ASP.NET Core 的 launchSettings.json 文件中添加 http:// 绑定。此绑定可以使用任意未占用的 localhost 端口。例如：http://localhost:34543。添加绑定后，请更新 mcp.json，以使用 http:// URL。

4. 在 GitHub Copilot 聊天中输入提示词，以在 VS Code 的 Agent 模式下使用 Xperience Community MCP Server 提供的工具。

   Tell me about some of the web page content types in this project and a summary of their structure and relationships. For example, let me know if some of these web page content types have references to content items of other types as part of their field definition.
   

完整说明

如需查看更详细的说明和示例，请参阅使用指南。

参与贡献

有关为 Kentico 开源软件贡献代码的指南，请参阅 Kentico 的 CONTRIBUTING.md 了解更多信息，并遵循 Kentico 的 CODE_OF_CONDUCT。

有关如何为此项目做出贡献的说明和技术细节，请参阅贡献设置。

许可证

本项目根据 MIT 许可证分发。详情请参阅 LICENSE.md。

安全

如有任何安全问题，请参阅 SECURITY.md。