Bringing the MCP server into the repo

mcp-server/src/AwesomeCopilot.McpServer/Tools/InstructionMode.cs

@@ -0,0 +1,19 @@
+using System.Text.Json.Serialization;
+
+namespace AwesomeCopilot.McpServer.Tools;
+
+[JsonConverter(typeof(JsonStringEnumConverter<InstructionMode>))]
+public enum InstructionMode
+{
+    [JsonStringEnumMemberName("undefined")]
+    Undefined,
+
+    [JsonStringEnumMemberName("chatmodes")]
+    ChatModes,
+
+    [JsonStringEnumMemberName("instructions")]
+    Instructions,
+
+    [JsonStringEnumMemberName("prompts")]
+    Prompts
+}

mcp-server/src/AwesomeCopilot.McpServer/Tools/MetadataTool.cs

@@ -0,0 +1,89 @@
+using System.ComponentModel;
+
+using AwesomeCopilot.McpServer.Models;
+using AwesomeCopilot.McpServer.Services;
+
+using ModelContextProtocol.Server;
+
+namespace AwesomeCopilot.McpServer.Tools;
+
+/// <summary>
+/// This provides interfaces for metadata tool operations.
+/// </summary>
+public interface IMetadataTool
+{
+    /// <summary>
+    /// Searches custom instructions based on keywords in their titles and descriptions.
+    /// </summary>
+    /// <param name="keywords">The keyword to search for</param>
+    /// <returns>A <see cref="MetadataResult"/> containing the search results.</returns>
+    Task<MetadataResult> SearchAsync(string keywords);
+
+    /// <summary>
+    /// Loads a custom instruction from the awesome-copilot repository.
+    /// </summary>
+    /// <param name="mode">The instruction mode</param>
+    /// <param name="filename">The filename of the instruction</param>
+    /// <returns>The file contents as a string</returns>
+    Task<string> LoadAsync(InstructionMode mode, string filename);
+}
+
+/// <summary>
+/// This represents the tools entity for metadata of Awesome Copilot repository.
+/// </summary>
+[McpServerToolType]
+public class MetadataTool(IMetadataService service, ILogger<MetadataTool> logger) : IMetadataTool
+{
+    /// <inheritdoc />
+    [McpServerTool(Name = "search_instructions", Title = "Searches custom instructions")]
+    [Description("Searches custom instructions based on keywords in their titles and descriptions.")]
+    public async Task<MetadataResult> SearchAsync(
+        [Description("The keyword to search for")] string keywords)
+    {
+        var result = new MetadataResult();
+        try
+        {
+            var metadata = await service.SearchAsync(keywords).ConfigureAwait(false);
+
+            logger.LogInformation("Search completed successfully with keyword '{Keywords}'.", keywords);
+
+            result.Metadata = metadata;
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "Error occurred while searching instructions with keyword '{Keywords}'.", keywords);
+
+            result.ErrorMessage = ex.Message;
+        }
+
+        return result;
+    }
+
+    /// <inheritdoc />
+    [McpServerTool(Name = "load_instruction", Title = "Loads a custom instruction")]
+    [Description("Loads a custom instruction from the repository.")]
+    public async Task<string> LoadAsync(
+        [Description("The instruction mode")] InstructionMode mode,
+        [Description("The filename of the instruction")] string filename)
+    {
+        try
+        {
+            if (mode == InstructionMode.Undefined)
+            {
+                throw new ArgumentException("Instruction mode must be defined.", nameof(mode));
+            }
+
+            var result = await service.LoadAsync(mode.ToString().ToLowerInvariant(), filename).ConfigureAwait(false);
+
+            logger.LogInformation("Load completed successfully with mode {Mode} and filename {Filename}.", mode, filename);
+
+            return result;
+        }
+        catch (Exception ex)
+        {
+            logger.LogError(ex, "Error occurred while loading instruction with mode {Mode} and filename {Filename}.", mode, filename);
+
+            return ex.Message;
+        }
+    }
+}