[WIP] Refactor everything server to be more modular and use recommended APIs.

* Updated architecture.md

* Refactor/renamed static.ts to file.ts

* Refactor/renamed complex.ts to args.ts

* Refactor/renamed template.ts to templates.ts.

* In resource.ts,
  -  improved registerEmbeddedResourcePrompt to allow selection of blob or text resource type.

* In file.ts
  - refactor/renamed registerStaticResources to registerFileResources to highlight the fact that it is using files as resources.

* In args.ts
  - refactor/renamed registerComplexPrompt to registerArgumentsPrompt to highlight the fact that it is demonstrating prompt arguments.

* Updated inline documentation throughout

src/everything/resources/files.ts

@@ -0,0 +1,90 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { dirname, join } from "path";
+import { fileURLToPath } from "url";
+import { readdirSync, readFileSync, statSync } from "fs";
+
+/**
+ * Register static file resources
+ * - Each file in src/everything/docs is exposed as an individual static resource
+ * - URIs follow the pattern: "demo://static/docs/<filename>"
+ * - Markdown (.md) files are served as mime type "text/markdown"
+ * - Text (.txt) files are served as mime type "text/plain"
+ * - JSON (.json) files are served as mime type "application/json"
+ *
+ * @param server
+ */
+export const registerFileResources = (server: McpServer) => {
+  // Read the entries in the docs directory
+  const __filename = fileURLToPath(import.meta.url);
+  const __dirname = dirname(__filename);
+  const docsDir = join(__dirname, "..", "docs");
+  let entries: string[] = [];
+  try {
+    entries = readdirSync(docsDir);
+  } catch (e) {
+    // If docs/ folder is missing or unreadable, just skip registration
+    return;
+  }
+
+  // Register each file as a static resource
+  for (const name of entries) {
+    // Only process files, not directories
+    const fullPath = join(docsDir, name);
+    try {
+      const st = statSync(fullPath);
+      if (!st.isFile()) continue;
+    } catch {
+      continue;
+    }
+
+    // Prepare file resource info
+    const uri = `demo://resource/static/document/${encodeURIComponent(name)}`;
+    const mimeType = getMimeType(name);
+    const displayName = `Docs: ${name}`;
+    const description = `Static document file exposed from /docs: ${name}`;
+
+    // Register file resource
+    server.registerResource(
+      displayName,
+      uri,
+      { mimeType, description },
+      async (uri) => {
+        const text = readFileSafe(fullPath);
+        return {
+          contents: [
+            {
+              uri: uri.toString(),
+              mimeType,
+              text,
+            },
+          ],
+        };
+      }
+    );
+  }
+};
+
+/**
+ * Get the mimetype based on filename
+ * @param fileName
+ */
+function getMimeType(fileName: string): string {
+  const lower = fileName.toLowerCase();
+  if (lower.endsWith(".md") || lower.endsWith(".markdown"))
+    return "text/markdown";
+  if (lower.endsWith(".txt")) return "text/plain";
+  if (lower.endsWith(".json")) return "application/json";
+  return "text/plain";
+}
+
+/**
+ * Read a file or return an error message if it fails
+ * @param path
+ */
+function readFileSafe(path: string): string {
+  try {
+    return readFileSync(path, "utf-8");
+  } catch (e) {
+    return `Error reading file: ${path}. ${e}`;
+  }
+}

src/everything/resources/index.ts

@@ -1,6 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { registerResourceTemplates } from "./template.js";
-import { registerStaticResources } from "./static.js";
+import { registerResourceTemplates } from "./templates.js";
+import { registerFileResources } from "./files.js";
 
 /**
  * Register the resources with the MCP server.
@@ -8,5 +8,5 @@ import { registerStaticResources } from "./static.js";
  */
 export const registerResources = (server: McpServer) => {
   registerResourceTemplates(server);
-  registerStaticResources(server);
+  registerFileResources(server);
 };

src/everything/resources/templates.ts

@@ -0,0 +1,128 @@
+import {
+  McpServer,
+  ResourceTemplate,
+} from "@modelcontextprotocol/sdk/server/mcp.js";
+
+const uriBase: string = "demo://resource/dynamic";
+const textUriBase: string = `${uriBase}/text`;
+const blobUriBase: string = `${uriBase}/blob`;
+const textUriTemplate: string = `${textUriBase}/{index}`;
+const blobUriTemplate: string = `${blobUriBase}/{index}`;
+
+/**
+ * Create a dynamic text resource
+ * - Exposed for use by embedded resource prompt example
+ * @param uri
+ * @param index
+ */
+export const textResource = (uri: URL, index: number) => {
+  const timestamp = new Date().toLocaleTimeString();
+  return {
+    uri: uri.toString(),
+    mimeType: "text/plain",
+    text: `Resource ${index}: This is a plaintext resource created at ${timestamp}`,
+  };
+};
+
+/**
+ * Create a dynamic blob resource
+ * - Exposed for use by embedded resource prompt example
+ * @param uri
+ * @param index
+ */
+export const blobResource = (uri: URL, index: number) => {
+  const timestamp = new Date().toLocaleTimeString();
+  const resourceText = Buffer.from(
+    `Resource ${index}: This is a base64 blob created at ${timestamp}`
+  ).toString("base64");
+  return {
+    uri: uri.toString(),
+    mimeType: "text/plain",
+    text: resourceText,
+  };
+};
+
+/**
+ * Create a dynamic text resource URI
+ * - Exposed for use by embedded resource prompt example
+ * @param index
+ */
+export const textResourceUri = (index: number) =>
+  new URL(`${textUriBase}/${index}`);
+
+/**
+ * Create a dynamic blob resource URI
+ * - Exposed for use by embedded resource prompt example
+ * @param index
+ */
+export const blobResourceUri = (index: number) =>
+  new URL(`${blobUriBase}/${index}`);
+
+/**
+ * Register resource templates with the MCP server.
+ * - Text and blob resources, dynamically generated from the URI {index} variable
+ * - Any finite integer is acceptable for the index variable
+ * - List resources method will not return these resources
+ * - These are only accessible via template URIs
+ * - Both blob and text resources:
+ *   - have content that is dynamically generated, including a timestamp
+ *   - have different template URIs
+ *     - Blob: "demo://resource/dynamic/blob/{index}"
+ *     - Text: "demo://resource/dynamic/text/{index}"
+ *
+ * @param server
+ */
+export const registerResourceTemplates = (server: McpServer) => {
+  // Parse the index from the URI
+  const parseIndex = (uri: URL, variables: Record<string, unknown>) => {
+    const uriError = `Unknown resource: ${uri.toString()}`;
+    if (
+      uri.toString().startsWith(textUriBase) &&
+      uri.toString().startsWith(blobUriBase)
+    ) {
+      throw new Error(uriError);
+    } else {
+      const idxStr = String((variables as any).index ?? "");
+      const idx = Number(idxStr);
+      if (Number.isFinite(idx) && Number.isInteger(idx)) {
+        return idx;
+      } else {
+        throw new Error(uriError);
+      }
+    }
+  };
+
+  // Register the text resource template
+  server.registerResource(
+    "Dynamic Text Resource",
+    new ResourceTemplate(textUriTemplate, { list: undefined }),
+    {
+      mimeType: "text/plain",
+      description:
+        "Plaintext dynamic resource fabricated from the {index} variable, which must be an integer.",
+    },
+    async (uri, variables) => {
+      const index = parseIndex(uri, variables);
+      return {
+        contents: [textResource(uri, index)],
+      };
+    }
+  );
+
+  // Register the blob resource template
+  server.registerResource(
+    "Dynamic Blob Resource",
+    new ResourceTemplate(blobUriTemplate, { list: undefined }),
+    {
+      mimeType: "application/octet-stream",
+      description:
+        "Binary (base64) dynamic resource fabricated from the {index} variable, which must be an integer.",
+    },
+    async (uri, variables) => {
+      const index = parseIndex(uri, variables);
+      return {
+        contents: [blobResource(uri, index)],
+      };
+    }
+  );
+};