WIP

Author: aaronpowell

samples/EverythingServer/Program.cs

@@ -2,6 +2,7 @@
 using Microsoft.Extensions.Hosting;
 using ModelContextProtocol.Protocol.Types;
 using EverythingServer.Tools;
+using EverythingServer;
 
 var builder = Host.CreateEmptyApplicationBuilder(settings: null);
 
@@ -18,7 +19,7 @@
                 new Prompt { Name= "simple_prompt", Description = "A prompt without arguments" },
                 new Prompt { Name= "complex_prompt", Description = "A prompt with arguments", Arguments = [
                     new PromptArgument { Name = "temperature", Description = "Temperature setting", Required = true },
-                    new PromptArgument { Name = "style", Description = "Output style", Required = false}
+                    new PromptArgument { Name = "style", Description = "Output style", Required = false }
                 ]
                 }
             ]
@@ -42,6 +43,47 @@
         {
             Messages = messages
         });
-    });
+    })
+    .WithListResourceTemplatesHandler((ctx, ct) =>
+    {
+        return Task.FromResult(new ListResourceTemplatesResult
+        {
+            ResourceTemplates =
+            [
+                new ResourceTemplate { Name = "Static Resource", Description = "A static resource with a numeric ID", UriTemplate = "test://static/resource/{id}" }
+            ]
+        });
+    })
+    .WithReadResourceHandler((ctx, ct) =>
+    {
+        var uri = ctx.Params?.Uri;
+
+        if (uri is null || !uri.StartsWith("test://static/resource/"))
+        {
+            throw new NotSupportedException($"Unknown resource: {uri}");
+        }
+
+        int index = int.Parse(uri["test://static/resource/".Length..]) - 1;
+
+        if (index < 0 || index >= ResourceGenerator.Resources.Count)
+        {
+            throw new NotSupportedException($"Unknown resource: {uri}");
+        }
+
+        var resource = ResourceGenerator.Resources[index];
+
+        return Task.FromResult(new ReadResourceResult
+        {
+            Contents = [new ResourceContents
+                {
+                    Uri = resource.Uri,
+                    MimeType = resource.MimeType,
+                    Blob = resource.Description,
+                    Name = resource.Description
+                }
+            ]
+        });
+    })
+    ;
 
 await builder.Build().RunAsync();

samples/EverythingServer/ResourceGenerator.cs

@@ -0,0 +1,37 @@
+using ModelContextProtocol.Protocol.Types;
+using System;
+using System.Collections.Generic;
+using System.Linq;
+
+namespace EverythingServer;
+
+static class ResourceGenerator
+{
+    private static readonly List<Resource> _resources = Enumerable.Range(1, 100).Select(i =>
+        {
+            var uri = $"test://static/resource/{i}";
+            if (i % 2 != 0)
+            {
+                return new Resource
+                {
+                    Uri = uri,
+                    Name = $"Resource {i}",
+                    MimeType = "text/plain",
+                    Description = $"Resource {i}: This is a plaintext resource"
+                };
+            }
+            else
+            {
+                var buffer = System.Text.Encoding.UTF8.GetBytes($"Resource {i}: This is a base64 blob");
+                return new Resource
+                {
+                    Uri = uri,
+                    Name = $"Resource {i}",
+                    MimeType = "application/octet-stream",
+                    Description = Convert.ToBase64String(buffer)
+                };
+            }
+        }).ToList();
+
+    public static IReadOnlyList<Resource> Resources => _resources;
+}

src/ModelContextProtocol/Protocol/Types/ResourceContents.cs

@@ -3,7 +3,7 @@
 namespace ModelContextProtocol.Protocol.Types;
 
 /// <summary>
-/// Represents the content of a resource.
+/// A known resource that the server is capable of reading.
 /// <see href="https://github.com/modelcontextprotocol/specification/blob/main/schema/2024-11-05/schema.json">See the schema for details</see>
 /// </summary>
 public class ResourceContents
@@ -32,4 +32,18 @@ public class ResourceContents
     /// </summary>
     [JsonPropertyName("blob")]
     public string? Blob { get; set; }
+
+    /// <summary>
+    /// A human-readable name for this resource.\n\nThis can be used by clients to populate UI elements.
+    /// </summary>
+    [JsonPropertyName("name")]
+    public string? Name { get; set; }
+
+    /// <summary>
+    /// The size of the raw resource content, in bytes (i.e., before base64 encoding or any tokenization), if known.
+    /// 
+    /// This can be used by Hosts to display file sizes and estimate context window usage.
+    /// </summary>
+    [JsonPropertyName("size")]
+    public long? Size { get; set; }
 }