Xperience Community MCP Server

描述

这是一个使用 .NET MCP Server SDK 专门为 Kentico 的 Xperience 项目构建的 MCP Server，并作为 NuGet 包安装。

为什么使用这个库？通过在 Kentico 的 Xperience 项目中向 AI代理 暴露一组明确的工具，该代理可以拥有更结构化的上下文和能力。这意味着它可以成为开发人员更好的副驾，帮助他们为使用 Kentico 的 Xperience 的营销人员构建功能。

要了解此项目的更多详细信息，请阅读博客文章 将您的 Kentico 的 Xperience 应用程序转变为 MCP Server。

截图

<a href="https://raw.githubusercontent.com/seangwright/xperience-community-mcp-server/main/images/mcp-server-vs-code-xperience-dancing-goat.png"> <img src="https://raw.githubusercontent.com/seangwright/xperience-community-mcp-server/main/images/mcp-server-vs-code-xperience-dancing-goat.png" width="400" alt="在VS Code中使用MCP Server"> </a>

要求

库版本矩阵

Xperience 版本	库版本
>= 30.6.1	2.0.0
>= 30.4.1	1.0.0

依赖项

• ASP.NET Core 8.0
• Xperience by Kentico

其他要求

• 支持 MCP Server 使用 HTTP 流传输的最新 2025 年 4 月版 VS Code (v1.100) 或更高版本。

包安装

使用 .NET CLI 将包添加到您的应用程序

dotnet add package XperienceCommunity.MCPServer

快速开始

1. 安装包后，更新您的 Xperience by Kentico 应用程序的 Program.cs

   // Program.cs
   
   // ...
   
   // 添加 MCP 依赖项
   if (builder.Environment.IsDevelopment())
   {
       builder.Services.AddXperienceMCPServer();
   }
   
   // ...
   
   // 添加 MCP 端点
   if (builder.Environment.IsDevelopment())
   {
       app.UseXperienceMCPServer();
   }
   
   app.Kentico().MapRoutes();
   
   // ...
   

2. 启动您的 Xperience by Kentico 应用程序。

3. 设置您的 MCP Server 配置 VS Code

   {
     "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 Server。默认的 MCP Server 路径前缀是 /xperience-mcp。

   您可以使用 VS Code 命令面板来 管理和启动您的 MCP Server，或者您可以点击 mcp.json 中您服务器配置上方的“启动”操作。

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

4. 在 VS Code 的 代理模式 中使用 GitHub Copilot 聊天中的提示，利用 Xperience Community MCP Server 暴露的工具。

   告诉我关于这个项目中的一些网页内容类型及其结构和关系的概述。例如，让我知道这些网页内容类型中的一些是否在其字段定义中引用了其他类型的内容项。
   

完整说明

查看 使用指南 获取更多详细说明和示例。

贡献

要查看贡献于 Kentico 开源软件的指南，请参阅 Kentico 的 CONTRIBUTING.md 以获取更多信息，并遵循 Kentico 的 CODE_OF_CONDUCT。

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

许可证

根据 MIT 许可证分发。请参阅 LICENSE.md 获取更多信息。

安全

对于任何安全问题，请参阅 SECURITY.md。