feat: add McpToolExtension(draft)

Author: WeihanLi

Directory.Packages.props

@@ -2,8 +2,8 @@
   <PropertyGroup>
     <ManagePackageVersionsCentrally>true</ManagePackageVersionsCentrally>
     <CentralPackageFloatingVersionsEnabled>true</CentralPackageFloatingVersionsEnabled>
-    <!-- https://learn.microsoft.com/en-us/nuget/concepts/auditing-packages -->    
-    <NuGetAudit>true</NuGetAudit>    
+    <!-- https://learn.microsoft.com/en-us/nuget/concepts/auditing-packages -->
+    <NuGetAudit>true</NuGetAudit>
     <NuGetAuditMode>all</NuGetAuditMode>
     <!-- https://learn.microsoft.com/en-us/nuget/reference/errors-and-warnings/nu1901-nu1904 -->
     <WarningsAsErrors>NU1901;NU1902;NU1903;NU1904</WarningsAsErrors>
@@ -16,7 +16,8 @@
     <PackageVersion Condition="'$(TargetFramework)'=='net9.0'" Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="$(AspNet9PackageVersion)" />
     <PackageVersion Condition="'$(TargetFramework)'=='net10.0'" Include="Microsoft.AspNetCore.Authentication.JwtBearer" Version="$(AspNet10PackageVersion)" />
     <PackageVersion Include="Microsoft.AspNetCore.OpenApi" Version="$(AspNet10PackageVersion)" />
+    <PackageVersion Include="ModelContextProtocol.AspNetCore" Version="0.1.0-preview.10" />
     <PackageVersion Include="Scalar.AspNetCore" Version="2.1.17" />
     <PackageVersion Include="WeihanLi.Common" Version="1.0.77" />
   </ItemGroup>
-</Project>
+</Project>

samples/WeihanLi.Web.Extensions.Samples/McpToolExtension.cs

@@ -0,0 +1,40 @@
+// Copyright (c) Weihan Li. All rights reserved.
+// Licensed under the MIT license.
+
+namespace WeihanLi.Web.Extensions.Samples;
+
+public interface IMcpToolEndpointMetadata
+{
+    string Name { get; set; }
+    string Description { get; set; }
+}
+
+public class McpToolEndpointMetadata : IMcpToolEndpointMetadata
+{
+    public string Name { get; set; } = string.Empty;
+    public string Description { get; set; } = string.Empty;
+}
+
+public static class McpToolExtension
+{
+    public static IEndpointConventionBuilder AsMcpTool<TBuilder>(this TBuilder builder, Action<McpToolEndpointMetadata>? toolConfigure = null)
+        where TBuilder : IEndpointConventionBuilder
+    {
+        ArgumentNullException.ThrowIfNull(builder);
+        var metadata = new McpToolEndpointMetadata();
+        toolConfigure?.Invoke(metadata);
+        builder.Add(c =>
+        {
+            if (string.IsNullOrEmpty(metadata.Name))
+            {
+                metadata.Name = c.DisplayName!;
+            }
+            if (string.IsNullOrEmpty(metadata.Description))
+            {
+                metadata.Description = c.DisplayName!;
+            }
+            c.Metadata.Add(metadata);
+        });
+        return builder;
+    }
+}

samples/WeihanLi.Web.Extensions.Samples/Program.cs

@@ -87,7 +87,7 @@
     options.UserIdFactory = static context => $"{context.GetUserIP()}";
 });
 
-// builder.Services.AddEndpointsApiExplorer();
+builder.Services.AddEndpointsApiExplorer();
 builder.Services.AddOpenApi();
 
 builder.Host.UseFluentAspectsServiceProviderFactory(options =>

samples/WeihanLi.Web.Extensions.Samples/WeihanLi.Web.Extensions.Samples.csproj

@@ -11,6 +11,7 @@
 
   <ItemGroup>
     <PackageReference Include="Microsoft.AspNetCore.OpenApi" />
+    <PackageReference Include="ModelContextProtocol.AspNetCore" />
     <PackageReference Include="Scalar.AspNetCore" />
   </ItemGroup>
 </Project>