@iress-oss/ids-mcp-server 0.0.1-dev.4 → 0.0.1

package/build/index.js

@@ -0,0 +1,51 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListResourcesRequestSchema, ListToolsRequestSchema, ReadResourceRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { SERVER_CONFIG, CAPABILITIES } from "./config.js";
+import { toolDefinitions } from "./tools.js";
+import { handleToolCall } from "./toolHandler.js";
+import { handleListResources, handleReadResource } from "./resourceHandlers.js";
+/**
+ * Create MCP server for Iress Design System (IDS) component library context
+ */
+const server = new Server(SERVER_CONFIG, { capabilities: CAPABILITIES });
+/**
+ * List available IDS component documentation resources
+ */
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+    return handleListResources();
+});
+/**
+ * Read content from a specific markdown file
+ */
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+    return handleReadResource(request);
+});
+/**
+ * List available IDS development tools
+ */
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: toolDefinitions,
+    };
+});
+/**
+ * Handle IDS component library tool calls
+ */
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const result = handleToolCall(request);
+    return result;
+});
+/**
+ * Start the server
+ */
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("IDS Component Library MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});

package/{dist → build}/iressHandlers.js

@@ -1,10 +1,10 @@
 /**
  * Tool handlers for Iress component-specific operations
  */
-import { z } from 'zod';
-import * as path from 'path';
-import { mapIressComponentToFile, extractIressComponents, readFileContent, } from './utils.js';
-import { DOCS_DIR } from './config.js';
+import { z } from "zod";
+import * as path from "path";
+import { mapIressComponentToFile, extractIressComponents, readFileContent, } from "./utils.js";
+import { DOCS_DIR } from "./config.js";
 export function handleGetIressComponentInfo(args) {
     const schema = z.object({
         component_name: z.string(),
@@ -18,7 +18,7 @@ export function handleGetIressComponentInfo(args) {
         return {
             content: [
                 {
-                    type: 'text',
+                    type: "text",
                     text: `Component "${component_name}" not found. Make sure you're using the correct Iress component name (e.g., IressButton, IressInput, IressTable).`,
                 },
             ],
@@ -29,78 +29,47 @@ export function handleGetIressComponentInfo(args) {
         const content = readFileContent(filePath);
         let response = `**${component_name} Component Documentation**\n\n`;
         // Extract overview/description
-        const lines = content.split('\n');
-        const overviewStart = lines.findIndex((line) => line.toLowerCase().includes('overview'));
+        const lines = content.split("\n");
+        const overviewStart = lines.findIndex((line) => line.toLowerCase().includes("overview"));
         if (overviewStart !== -1) {
-            const overviewEnd = lines.findIndex((line, index) => index > overviewStart && line.startsWith('#'));
+            const overviewEnd = lines.findIndex((line, index) => index > overviewStart && line.startsWith("#"));
             const overviewLines = lines.slice(overviewStart, overviewEnd !== -1 ? overviewEnd : overviewStart + 10);
-            response += `${overviewLines.join('\n')}\n\n`;
+            response += `${overviewLines.join("\n")}\n\n`;
         }
         // Include props if requested
         if (include_props) {
-            const propSections = content.match(/(mode|prop|Properties|API)[\s\S]*?(?=\n##|\n\[#|$)/gi) ??
+            const propSections = content.match(/(mode|prop|Properties|API)[\s\S]*?(?=\n##|\n\[#|$)/gi) ||
                 [];
             if (propSections.length > 0) {
                 response += `**Props & API:**\n${propSections
                     .slice(0, 3)
-                    .join('\n\n')}\n\n`;
+                    .join("\n\n")}\n\n`;
             }
         }
         // Include examples if requested
         if (include_examples) {
-            const codeBlocks = content.match(/```[\s\S]*?```/g) ?? [];
-            const jsxBlocks = content.match(/<Iress[A-Z][^>]*>[\s\S]*?<\/Iress[A-Z][^>]*>/g) ?? [];
+            const codeBlocks = content.match(/```[\s\S]*?```/g) || [];
+            const jsxBlocks = content.match(/<Iress[A-Z][^>]*>[\s\S]*?<\/Iress[A-Z][^>]*>/g) || [];
             const examples = [...codeBlocks, ...jsxBlocks];
             if (examples.length > 0) {
                 response += `**Usage Examples:**\n${examples
                     .slice(0, 3)
-                    .join('\n\n')}\n\n`;
+                    .join("\n\n")}\n\n`;
             }
         }
         return {
             content: [
                 {
-                    type: 'text',
+                    type: "text",
                     text: response,
                 },
             ],
         };
     }
     catch (error) {
-        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-        throw new Error(`Failed to read component documentation: ${errorMessage}`);
+        throw new Error(`Failed to read component documentation: ${error}`);
     }
 }
-function formatComponentDetails(componentName, componentFile) {
-    if (!componentFile) {
-        return `**${componentName}** ❌ Not found\n\n`;
-    }
-    try {
-        const filePath = path.join(DOCS_DIR, componentFile);
-        const content = readFileContent(filePath);
-        const lines = content.split('\n');
-        const description = lines
-            .slice(0, 20)
-            .find((line) => line.trim() &&
-            !line.startsWith('#') &&
-            !line.startsWith('<!--') &&
-            !line.includes('Overview') &&
-            line.length > 20)
-            ?.trim() ?? 'IDS component';
-        return `**${componentName}** ✅\n  - File: ${componentFile}\n  - Description: ${description}\n\n`;
-    }
-    catch {
-        return `**${componentName}** ❌\n  - Error reading documentation\n\n`;
-    }
-}
-function formatComponentSummary(componentName, componentFile) {
-    const status = componentFile ? '✅ Available' : '❌ Not found';
-    let result = `**${componentName}** ${status}\n`;
-    if (componentFile) {
-        result += `  - Documentation: ${componentFile}\n`;
-    }
-    return result + '\n';
-}
 export function handleAnalyzeComponentMentions(args) {
     const schema = z.object({
         text: z.string(),
@@ -112,7 +81,7 @@ export function handleAnalyzeComponentMentions(args) {
         return {
             content: [
                 {
-                    type: 'text',
+                    type: "text",
                     text: "No Iress component mentions found in the provided text. Components should be mentioned with the 'Iress' prefix (e.g., IressButton, IressInput).",
                 },
             ],
@@ -122,21 +91,46 @@ export function handleAnalyzeComponentMentions(args) {
     for (const componentName of componentMentions) {
         const componentFile = mapIressComponentToFile(componentName);
         if (detailed && componentFile) {
-            response += formatComponentDetails(componentName, componentFile);
+            try {
+                const filePath = path.join(DOCS_DIR, componentFile);
+                const content = readFileContent(filePath);
+                // Get brief description
+                const lines = content.split("\n");
+                const description = lines
+                    .slice(0, 20)
+                    .find((line) => line.trim() &&
+                    !line.startsWith("#") &&
+                    !line.startsWith("<!--") &&
+                    !line.includes("Overview") &&
+                    line.length > 20)
+                    ?.trim() || "IDS component";
+                response += `**${componentName}** ✅\n`;
+                response += `  - File: ${componentFile}\n`;
+                response += `  - Description: ${description}\n\n`;
+            }
+            catch (error) {
+                response += `**${componentName}** ❌\n`;
+                response += `  - Error reading documentation\n\n`;
+            }
         }
         else {
-            response += formatComponentSummary(componentName, componentFile);
+            const status = componentFile ? "✅ Available" : "❌ Not found";
+            response += `**${componentName}** ${status}\n`;
+            if (componentFile) {
+                response += `  - Documentation: ${componentFile}\n`;
+            }
+            response += "\n";
         }
     }
     if (!detailed &&
         componentMentions.some((name) => mapIressComponentToFile(name))) {
         response +=
-            '\n*Use the `get_iress_component_info` tool with a specific component name for detailed information.*';
+            "\n*Use the `get_iress_component_info` tool with a specific component name for detailed information.*";
     }
     return {
         content: [
             {
-                type: 'text',
+                type: "text",
                 text: response,
             },
         ],

package/{dist → build}/resourceHandlers.js

@@ -1,36 +1,36 @@
 /**
  * Resource handlers for MCP server
  */
-import * as path from 'path';
-import { getMarkdownFiles, readFileContent } from './utils.js';
-import { DOCS_DIR } from './config.js';
+import * as path from "path";
+import { getMarkdownFiles, readFileContent } from "./utils.js";
+import { DOCS_DIR } from "./config.js";
 export function handleListResources() {
     const markdownFiles = getMarkdownFiles();
     // Categorize resources for better organization
     const categorizedResources = markdownFiles.map((file) => {
-        let category = 'Other';
+        let category = "Other";
         let name = file;
-        if (file.startsWith('components-')) {
-            category = 'Components';
-            name = file.replace('components-', '').replace('-docs.md', '');
+        if (file.startsWith("components-")) {
+            category = "Components";
+            name = file.replace("components-", "").replace("-docs.md", "");
         }
-        else if (file.startsWith('foundations-')) {
-            category = 'Foundations';
-            name = file.replace('foundations-', '').replace('-docs.md', '');
+        else if (file.startsWith("foundations-")) {
+            category = "Foundations";
+            name = file.replace("foundations-", "").replace("-docs.md", "");
         }
-        else if (file.startsWith('resources-')) {
-            category = 'Resources';
-            name = file.replace('resources-', '').replace('-docs.md', '');
+        else if (file.startsWith("resources-")) {
+            category = "Resources";
+            name = file.replace("resources-", "").replace("-docs.md", "");
         }
-        else if (file.includes('introduction')) {
-            category = 'Getting Started';
-            name = 'Introduction';
+        else if (file.includes("introduction")) {
+            category = "Getting Started";
+            name = "Introduction";
         }
         return {
             uri: `file://${path.join(DOCS_DIR, file)}`,
             name: `${category}: ${name}`,
             description: `IDS ${category.toLowerCase()} documentation for ${name}`,
-            mimeType: 'text/markdown',
+            mimeType: "text/markdown",
         };
     });
     return {
@@ -39,14 +39,14 @@ export function handleListResources() {
 }
 export function handleReadResource(request) {
     const url = new URL(request.params.uri);
-    if (url.protocol !== 'file:') {
+    if (url.protocol !== "file:") {
         throw new Error(`Unsupported protocol: ${url.protocol}`);
     }
     const filePath = url.pathname;
     // Ensure the file is within our docs directory
     const relativePath = path.relative(DOCS_DIR, filePath);
-    if (relativePath.startsWith('..') || path.isAbsolute(relativePath)) {
-        throw new Error('Access denied: File is outside the docs directory');
+    if (relativePath.startsWith("..") || path.isAbsolute(relativePath)) {
+        throw new Error("Access denied: File is outside the docs directory");
     }
     try {
         const content = readFileContent(filePath);
@@ -54,14 +54,13 @@ export function handleReadResource(request) {
             contents: [
                 {
                     uri: request.params.uri,
-                    mimeType: 'text/markdown',
+                    mimeType: "text/markdown",
                     text: content,
                 },
             ],
         };
     }
     catch (error) {
-        const errorMessage = error instanceof Error ? error.message : 'Unknown error';
-        throw new Error(`Failed to read file: ${errorMessage}`);
+        throw new Error(`Failed to read file: ${error}`);
     }
 }

package/{dist → build}/searchHandlers.js

@@ -1,10 +1,10 @@
 /**
  * Tool handlers for search and documentation operations
  */
-import { z } from 'zod';
-import * as path from 'path';
-import { getMarkdownFiles, readFileContent } from './utils.js';
-import { DOCS_DIR } from './config.js';
+import { z } from "zod";
+import * as path from "path";
+import { getMarkdownFiles, readFileContent } from "./utils.js";
+import { DOCS_DIR } from "./config.js";
 export function handleGetUsageExamples(args) {
     const schema = z.object({
         component: z.string(),
@@ -14,18 +14,18 @@ export function handleGetUsageExamples(args) {
     const markdownFiles = getMarkdownFiles();
     // Find component files (main + recipes)
     const componentFiles = markdownFiles.filter((file) => file.includes(`${component.toLowerCase()}`) ||
-        (file.includes('recipes') &&
+        (file.includes("recipes") &&
             file.toLowerCase().includes(component.toLowerCase())));
     if (componentFiles.length === 0) {
         return {
             content: [
                 {
-                    type: 'text',
+                    type: "text",
                     text: `No examples found for "${component}". Try: ${markdownFiles
-                        .filter((f) => f.startsWith('components-'))
+                        .filter((f) => f.startsWith("components-"))
                         .slice(0, 5)
-                        .map((f) => f.replace('components-', '').replace('-docs.md', ''))
-                        .join(', ')}`,
+                        .map((f) => f.replace("components-", "").replace("-docs.md", ""))
+                        .join(", ")}`,
                 },
             ],
         };
@@ -36,8 +36,8 @@ export function handleGetUsageExamples(args) {
             const filePath = path.join(DOCS_DIR, file);
             const content = readFileContent(filePath);
             // Extract code examples
-            const codeBlocks = content.match(/```[\s\S]*?```/g) ?? [];
-            const jsxBlocks = content.match(/<[A-Z][^>]*>[\s\S]*?<\/[A-Z][^>]*>/g) ?? [];
+            const codeBlocks = content.match(/```[\s\S]*?```/g) || [];
+            const jsxBlocks = content.match(/<[A-Z][^>]*>[\s\S]*?<\/[A-Z][^>]*>/g) || [];
             if (pattern) {
                 // Filter examples by pattern
                 const patternMatches = [...codeBlocks, ...jsxBlocks].filter((block) => block.toLowerCase().includes(pattern.toLowerCase()));
@@ -51,18 +51,13 @@ export function handleGetUsageExamples(args) {
             console.error(`Error reading file ${file}:`, error);
         }
     }
-    const patternSuffix = pattern ? ` (${pattern} pattern)` : '';
-    const patternNotFoundSuffix = pattern ? ` with pattern "${pattern}"` : '';
-    const examplesText = examples.length > 0
-        ? `**${component} Usage Examples**${patternSuffix}:\n\n${examples
-            .slice(0, 5)
-            .join('\n\n---\n\n')}`
-        : `No usage examples found for "${component}"${patternNotFoundSuffix}.`;
     return {
         content: [
             {
-                type: 'text',
-                text: examplesText,
+                type: "text",
+                text: examples.length > 0
+                    ? `**${component} Usage Examples**${pattern ? ` (${pattern} pattern)` : ""}:\n\n${examples.slice(0, 5).join("\n\n---\n\n")}`
+                    : `No usage examples found for "${component}"${pattern ? ` with pattern "${pattern}"` : ""}.`,
             },
         ],
     };
@@ -79,7 +74,7 @@ export function handleSearchIdsDocs(args) {
         try {
             const filePath = path.join(DOCS_DIR, file);
             const content = readFileContent(filePath);
-            const lines = content.split('\n');
+            const lines = content.split("\n");
             lines.forEach((line, index) => {
                 const searchLine = case_sensitive ? line : line.toLowerCase();
                 const searchQuery = case_sensitive ? query : query.toLowerCase();
@@ -87,9 +82,9 @@ export function handleSearchIdsDocs(args) {
                     // Get context (surrounding lines)
                     const contextStart = Math.max(0, index - 1);
                     const contextEnd = Math.min(lines.length - 1, index + 1);
-                    const context = lines.slice(contextStart, contextEnd + 1).join('\n');
+                    const context = lines.slice(contextStart, contextEnd + 1).join("\n");
                     results.push({
-                        file: file.replace('-docs.md', '').replace(/^[a-z]+-/, ''),
+                        file: file.replace("-docs.md", "").replace(/^[a-z]+-/, ""),
                         line: index + 1,
                         content: line.trim(),
                         context,
@@ -104,12 +99,12 @@ export function handleSearchIdsDocs(args) {
     return {
         content: [
             {
-                type: 'text',
+                type: "text",
                 text: results.length > 0
                     ? `Found ${results.length} matches in IDS documentation:\n\n${results
                         .slice(0, 15) // Limit results
                         .map((r) => `**${r.file}:${r.line}**\n\`\`\`\n${r.context}\n\`\`\``)
-                        .join('\n\n')}`
+                        .join("\n\n")}`
                     : `No matches found for "${query}" in IDS documentation.`,
             },
         ],
@@ -118,32 +113,31 @@ export function handleSearchIdsDocs(args) {
 export function handleGetDesignTokens(args) {
     const schema = z.object({
         type: z
-            .enum(['colors', 'spacing', 'typography', 'breakpoints', 'all'])
-            .default('all'),
+            .enum(["colors", "spacing", "typography", "breakpoints", "all"])
+            .default("all"),
     });
     const { type } = schema.parse(args);
     const markdownFiles = getMarkdownFiles();
     // Find foundation files related to design tokens
-    const foundationFiles = markdownFiles.filter((file) => file.startsWith('foundations-') &&
-        (type === 'all' || file.includes(type)));
+    const foundationFiles = markdownFiles.filter((file) => file.startsWith("foundations-") && (type === "all" || file.includes(type)));
     const tokenInfo = [];
     for (const file of foundationFiles) {
         try {
             const filePath = path.join(DOCS_DIR, file);
             const content = readFileContent(filePath);
             // Extract CSS custom properties and token information
-            const cssVariables = content.match(/--iress-[a-z-]+/g) ?? [];
-            const tokenSections = content.match(/#{2,3}\s+[^#\n]+/g) ?? [];
+            const cssVariables = content.match(/--iress-[a-z-]+/g) || [];
+            const tokenSections = content.match(/###?\s+[^#\n]+[\s\S]*?(?=###|$)/g) || [];
             if (cssVariables.length > 0 || tokenSections.length > 0) {
                 let fileInfo = `**${file
-                    .replace('foundations-', '')
-                    .replace('-docs.md', '')}**\n`;
+                    .replace("foundations-", "")
+                    .replace("-docs.md", "")}**\n`;
                 if (cssVariables.length > 0) {
                     const uniqueVars = [...new Set(cssVariables)].slice(0, 10);
-                    fileInfo += `CSS Variables: ${uniqueVars.join(', ')}\n`;
+                    fileInfo += `CSS Variables: ${uniqueVars.join(", ")}\n`;
                 }
                 if (tokenSections.length > 0) {
-                    fileInfo += `\n${tokenSections.slice(0, 3).join('\n\n')}`;
+                    fileInfo += `\n${tokenSections.slice(0, 3).join("\n\n")}`;
                 }
                 tokenInfo.push(fileInfo);
             }
@@ -152,61 +146,20 @@ export function handleGetDesignTokens(args) {
             console.error(`Error reading file ${file}:`, error);
         }
     }
-    const typeLabel = type !== 'all' ? ` (${type})` : '';
-    const typeNotFoundLabel = type !== 'all' ? ` for ${type}` : '';
     return {
         content: [
             {
-                type: 'text',
+                type: "text",
                 text: tokenInfo.length > 0
-                    ? `**IDS Design Tokens${typeLabel}**\n\n${tokenInfo.join('\n\n---\n\n')}`
-                    : `No design token information found${typeNotFoundLabel}. Available foundations: ${markdownFiles
-                        .filter((f) => f.startsWith('foundations-'))
-                        .map((f) => f.replace('foundations-', '').replace('-docs.md', ''))
-                        .join(', ')}`,
+                    ? `**IDS Design Tokens${type !== "all" ? ` (${type})` : ""}**\n\n${tokenInfo.join("\n\n---\n\n")}`
+                    : `No design token information found${type !== "all" ? ` for ${type}` : ""}. Available foundations: ${markdownFiles
+                        .filter((f) => f.startsWith("foundations-"))
+                        .map((f) => f.replace("foundations-", "").replace("-docs.md", ""))
+                        .join(", ")}`,
             },
         ],
     };
 }
-function findSectionContent(content, section) {
-    const sectionRegex = new RegExp(`(#{1,3}\\s+.*${section}.*?(?=#{1,3}|$))`, 'gis');
-    const sectionMatch = sectionRegex.exec(content);
-    if (sectionMatch) {
-        return sectionMatch[0];
-    }
-    // Try to find sections that contain the search term
-    const sections = content.split(/(?=#{1,3}\s+)/);
-    const matchingSections = sections.filter((sectionContent) => sectionContent.toLowerCase().includes(section.toLowerCase()));
-    return matchingSections.length > 0 ? matchingSections.join('\n\n') : null;
-}
-function addContextLines(lines, startIndex, endIndex, contextLines) {
-    for (let j = startIndex; j < endIndex; j++) {
-        if (!contextLines.includes(lines[j])) {
-            contextLines.push(lines[j]);
-        }
-    }
-}
-function filterContentByQuery(content, query) {
-    const lines = content.split('\n');
-    const contextLines = [];
-    const queryLower = query.toLowerCase();
-    for (let i = 0; i < lines.length; i++) {
-        const line = lines[i];
-        if (line.toLowerCase().includes(queryLower)) {
-            // Add context lines before
-            const startContext = Math.max(0, i - 3);
-            addContextLines(lines, startContext, i, contextLines);
-            // Add the matching line
-            if (!contextLines.includes(line)) {
-                contextLines.push(line);
-            }
-            // Add context lines after
-            const endContext = Math.min(lines.length, i + 4);
-            addContextLines(lines, i + 1, endContext, contextLines);
-        }
-    }
-    return contextLines.length > 0 ? contextLines.join('\n') : null;
-}
 export function handleGetDesignGuidelines(args) {
     const schema = z.object({
         section: z.string().optional(),
@@ -215,14 +168,14 @@ export function handleGetDesignGuidelines(args) {
     const { section, query } = schema.parse(args);
     try {
         // Read the guidelines.md file from the docs directory
-        const guidelinesPath = path.join(DOCS_DIR, 'guidelines.md');
+        const guidelinesPath = path.join(DOCS_DIR, "..", "guidelines.md");
         const content = readFileContent(guidelinesPath);
         if (!content) {
             return {
                 content: [
                     {
-                        type: 'text',
-                        text: 'Design guidelines file not found. Please ensure guidelines.md exists in the docs directory.',
+                        type: "text",
+                        text: "Design guidelines file not found. Please ensure guidelines.md exists in the docs directory.",
                     },
                 ],
             };
@@ -230,56 +183,88 @@ export function handleGetDesignGuidelines(args) {
         let filteredContent = content;
         // Filter by section if specified
         if (section) {
-            const sectionContent = findSectionContent(content, section);
-            if (sectionContent) {
-                filteredContent = sectionContent;
+            const sectionRegex = new RegExp(`(#{1,3}\\s+.*${section}.*?(?=#{1,3}|$))`, "gis");
+            const sectionMatch = content.match(sectionRegex);
+            if (sectionMatch) {
+                filteredContent = sectionMatch[0];
             }
             else {
-                return {
-                    content: [
-                        {
-                            type: 'text',
-                            text: `Section "${section}" not found in design guidelines. Available sections include: Core Design Principles, Visual Design Standards, Component Guidelines, Accessibility, Layout Systems, and Best Practices.`,
-                        },
-                    ],
-                };
+                // Try to find sections that contain the search term
+                const sections = content.split(/(?=#{1,3}\s+)/);
+                const matchingSections = sections.filter((section) => section.toLowerCase().includes(section.toLowerCase()));
+                if (matchingSections.length > 0) {
+                    filteredContent = matchingSections.join("\n\n");
+                }
+                else {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: `Section "${section}" not found in design guidelines. Available sections include: Core Design Principles, Visual Design Standards, Component Guidelines, Accessibility, Layout Systems, and Best Practices.`,
+                            },
+                        ],
+                    };
+                }
             }
         }
         // Filter by query if specified
         if (query) {
-            const queryContent = filterContentByQuery(filteredContent, query);
-            if (queryContent) {
-                filteredContent = queryContent;
+            const lines = filteredContent.split("\n");
+            const relevantLines = [];
+            let contextLines = [];
+            for (let i = 0; i < lines.length; i++) {
+                const line = lines[i];
+                if (line.toLowerCase().includes(query.toLowerCase())) {
+                    // Add context lines before
+                    const startContext = Math.max(0, i - 3);
+                    for (let j = startContext; j < i; j++) {
+                        if (!contextLines.includes(lines[j])) {
+                            contextLines.push(lines[j]);
+                        }
+                    }
+                    // Add the matching line
+                    if (!contextLines.includes(line)) {
+                        contextLines.push(line);
+                    }
+                    // Add context lines after
+                    const endContext = Math.min(lines.length, i + 4);
+                    for (let j = i + 1; j < endContext; j++) {
+                        if (!contextLines.includes(lines[j])) {
+                            contextLines.push(lines[j]);
+                        }
+                    }
+                }
+            }
+            if (contextLines.length > 0) {
+                filteredContent = contextLines.join("\n");
             }
             else {
                 return {
                     content: [
                         {
-                            type: 'text',
+                            type: "text",
                             text: `No guidelines found matching "${query}". Try searching for terms like: accessibility, typography, colors, spacing, components, principles, or usability.`,
                         },
                     ],
                 };
             }
         }
-        const sectionSuffix = section ? ` - ${section}` : '';
-        const querySuffix = query ? ` (filtered by: ${query})` : '';
         return {
             content: [
                 {
-                    type: 'text',
-                    text: `**IDS Design Guidelines${sectionSuffix}${querySuffix}**\n\n${filteredContent}`,
+                    type: "text",
+                    text: `**IDS Design Guidelines${section ? ` - ${section}` : ""}${query ? ` (filtered by: ${query})` : ""}**\n\n${filteredContent}`,
                 },
             ],
         };
     }
     catch (error) {
-        console.error('Error reading guidelines:', error);
+        console.error("Error reading guidelines:", error);
         return {
             content: [
                 {
-                    type: 'text',
-                    text: 'Error reading design guidelines. Please ensure the guidelines.md file exists and is accessible.',
+                    type: "text",
+                    text: "Error reading design guidelines. Please ensure the guidelines.md file exists and is accessible.",
                 },
             ],
         };