@sebgroup/green-core 2.21.0-rc.20260112150926042 → 2.21.0-rc.20260113130744922

package/bin/mcp-server/resources.js

@@ -61,6 +61,14 @@ function setupResourceHandlers(server) {
         }
       }
       if (globalIndex) {
+        if (globalIndex.instructions) {
+          resources.push({
+            uri: "green://instructions",
+            name: "Green Design System Instructions",
+            description: "General instructions and guidelines for agents using the Green Design System MCP",
+            mimeType: "text/markdown"
+          });
+        }
         for (const guide of globalIndex.guides) {
           const name = guide.path.replace(/^(guides|concepts)\//, "").replace(/\.md$/, "");
           const category = guide.path.startsWith("guides/") ? "guides" : "concepts";
@@ -82,6 +90,21 @@ function setupResourceHandlers(server) {
   server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
     const { uri } = request.params;
     try {
+      if (uri === "green://instructions") {
+        const content2 = await readMcpFile("INSTRUCTIONS.md");
+        if (!content2) {
+          throw new Error("Instructions file not found");
+        }
+        return {
+          contents: [
+            {
+              uri,
+              mimeType: "text/markdown",
+              text: content2
+            }
+          ]
+        };
+      }
       const parsed = parseResourceUri(uri);
       if (!parsed) {
         throw new Error(`Invalid resource URI: ${uri}`);

package/bin/mcp-server/tools.js

@@ -106,6 +106,15 @@ function setupToolHandlers(server) {
             },
             required: ["name"]
           }
+        },
+        {
+          name: "get_instructions",
+          description: "Get the base instructions for using the Green Design System MCP. These instructions contain critical rules, typography guidelines, layout system requirements, and general best practices that should be read before implementing any Green components.",
+          inputSchema: {
+            type: "object",
+            properties: {},
+            required: []
+          }
         }
       ]
     };
@@ -126,6 +135,8 @@ function setupToolHandlers(server) {
           return await handleListGuides(args);
         case "get_guide":
           return await handleGetGuide(args);
+        case "get_instructions":
+          return await handleGetInstructions();
         default:
           throw new Error(`Unknown tool: ${name}`);
       }
@@ -408,6 +419,33 @@ ${content}`
     throw new Error(`Failed to get guide: ${error}`);
   }
 }
+async function handleGetInstructions() {
+  try {
+    const globalIndex = await loadGlobalIndex();
+    if (!globalIndex) {
+      throw new Error("Failed to load global index");
+    }
+    if (!globalIndex.instructions) {
+      throw new Error(
+        "Instructions not available. The MCP may not have been generated with instructions support."
+      );
+    }
+    const content = await readMcpFile("INSTRUCTIONS.md");
+    if (!content) {
+      throw new Error("Instructions file not found");
+    }
+    return {
+      content: [
+        {
+          type: "text",
+          text: content
+        }
+      ]
+    };
+  } catch (error) {
+    throw new Error(`Failed to get instructions: ${error}`);
+  }
+}
 export {
   setupToolHandlers
 };

package/bin/mcp-server/types.d.ts

@@ -59,6 +59,7 @@ export interface IconsIndex {
 export interface GlobalIndex {
     version: string;
     generatedAt: string;
+    instructions?: string;
     components: string;
     icons: string;
     guides: GuideEntry[];