Xperience Community MCP Server

Xperience Community MCP Server

説明

警告

このパッケージは非推奨になりました。代わりに、以下の Xperience by Kentico のネイティブ AI 機能を使用してください。

• コンテンツタイプ管理 API ＋ MCP サーバー
• ドキュメント MCP サーバー
• コンテンツモデリング MCP サーバー

Xperience by Kentico プロジェクト向けに構築され、NuGet パッケージとしてインストールされる、.NET MCP Server SDK で構築された MCP サーバー です。

このライブラリを使用する理由は何でしょうか？ Xperience by Kentico プロジェクトで、ドキュメント化された個別のツールセットを AI エージェント に公開することで、そのエージェントは、より適切に構造化されたコンテキストと機能を利用できます。これにより、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

その他の要件

• HTTP ストリーミングを使用する MCP サーバーをサポートする、VS Code の2025 年 4 月の最新リリース（v1.100）以降。

パッケージのインストール

.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 のエージェントモードで 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 のもとで配布されています。詳細については、LICENSE.mdをご覧ください。

セキュリティ

セキュリティ上の問題については、SECURITY.mdをご覧ください。