http-client-mcp-server 1.0.0 → 1.1.0

package/README.md

@@ -1,4 +1,4 @@
-# ACW Repo Reader (HTTP Client MCP Server)
+# http-client-mcp-server
 
 A Model Context Protocol (MCP) server that provides a set of tools to explore and read files from a repository. This is specifically designed to help AI agents understand and navigate large codebases.
 

package/index.js

@@ -4,25 +4,131 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
 import fs from "node:fs/promises";
 import path from "node:path";
+import yaml from "js-yaml";
+const IGNORED_DIRS = [
+    "node_modules",
+    ".git",
+    ".idea",
+    ".vscode",
+    "dist",
+    "build",
+    ".next",
+    ".cache",
+];
+const MAX_SEARCH_RESULTS = 50;
+const MAX_LIST_ENTRIES = 100;
+const MAX_FILE_SIZE_BYTES = 100 * 1024; // 100KB
+function pruneOpenApiObject(obj) {
+    if (!obj || typeof obj !== "object")
+        return obj;
+    if (Array.isArray(obj)) {
+        return obj.map(pruneOpenApiObject);
+    }
+    const pruned = {};
+    const skipKeys = ["description", "summary", "example", "examples"];
+    for (const [key, value] of Object.entries(obj)) {
+        if (skipKeys.includes(key) || key.startsWith("x-")) {
+            continue;
+        }
+        pruned[key] = pruneOpenApiObject(value);
+    }
+    return pruned;
+}
+/**
+ * Minifies JSON code blocks in Markdown.
+ */
+function minifyJsonInMarkdown(text) {
+    return text.replace(/```json([\s\S]*?)```/g, (match, jsonStr) => {
+        try {
+            const minified = JSON.stringify(JSON.parse(jsonStr.trim()));
+            return `\`\`\`json\n${minified}\n\`\`\``;
+        }
+        catch {
+            return match;
+        }
+    });
+}
+/**
+ * Flattens Markdown tables into concise bulleted lists.
+ */
+function flattenMarkdownTables(text) {
+    const lines = text.split("\n");
+    const result = [];
+    let inTable = false;
+    let headers = [];
+    for (const line of lines) {
+        const isDivider = /^[\s|:-]+$/.test(line);
+        const isRow = line.trim().startsWith("|") && line.trim().endsWith("|");
+        if (isRow && !isDivider) {
+            const cells = line
+                .split("|")
+                .map((c) => c.trim())
+                .filter((c, i, arr) => i > 0 && i < arr.length - 1);
+            if (!inTable) {
+                inTable = true;
+                headers = cells;
+                continue;
+            }
+            // It's a data row
+            if (cells.length > 0) {
+                const formatted = cells
+                    .map((cell, i) => {
+                    const header = headers[i] || `col${i}`;
+                    return cell ? `${header}: ${cell}` : "";
+                })
+                    .filter(Boolean)
+                    .join(", ");
+                result.push(`- ${formatted}`);
+            }
+        }
+        else {
+            if (inTable && !isDivider && !isRow) {
+                inTable = false;
+            }
+            if (!isDivider) {
+                result.push(line);
+            }
+        }
+    }
+    return result.join("\n");
+}
+function optimizeMarkdown(text) {
+    let optimized = text;
+    optimized = optimized.replace(/-- no response --/gi, "");
+    optimized = optimized.replace(/Content-Type: application\/json/gi, "");
+    optimized = flattenMarkdownTables(optimized);
+    optimized = minifyJsonInMarkdown(optimized);
+    const seenBlocks = new Set();
+    optimized = optimized.replace(/```[\s\S]*?```/g, (match) => {
+        const cleaned = match.replace(/\s/g, ""); // canonicalize
+        if (seenBlocks.has(cleaned) && cleaned.length > 50) {
+            return "[Same body as above]";
+        }
+        seenBlocks.add(cleaned);
+        return match;
+    });
+    optimized = optimized.replace(/\n\s*\n\s*\n+/g, "\n\n");
+    return optimized.trim();
+}
 const rawRepoPath = process.env.REPO_BASE_PATH || process.argv[2];
 if (!rawRepoPath) {
     const currentPath = process.cwd();
     console.error("Error: REPO_BASE_PATH environment variable or a command-line argument is required.");
     console.error(`\nHint: If you want to use the current directory, the absolute path is:\n${currentPath}`);
-    console.error(`\nUsage example:\nacw-repo-reader ${currentPath}`);
+    console.error(`\nUsage example:\nhttp-client-mcp-server ${currentPath}`);
     console.error("\nTips to find your repository path:");
     console.error("- macOS: Right-click folder + hold 'Option' key -> Select 'Copy as Pathname'");
     console.error("- Windows: Shift + Right-click folder -> Select 'Copy as path'");
     process.exit(1);
 }
 const REPO_BASE_PATH = path.resolve(rawRepoPath);
-const server = new Server({ name: "acw-repo-reader", version: "1.0.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "http-client-mcp-server", version: "1.0.0" }, { capabilities: { tools: {} } });
 server.setRequestHandler(ListToolsRequestSchema, async () => {
     return {
         tools: [
             {
                 name: "read_api_spec",
-                description: "Reads API specifications, sequence diagrams, or any files from repository.",
+                description: "Reads API specifications, source code, or any files. Supports line ranges for large files.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -30,13 +136,43 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
                             type: "string",
                             description: "Relative path to the file inside the repo",
                         },
+                        startLine: {
+                            type: "number",
+                            description: "Optional start line number (1-based)",
+                        },
+                        endLine: {
+                            type: "number",
+                            description: "Optional end line number (1-based)",
+                        },
                     },
                     required: ["filepath"],
                 },
             },
+            {
+                name: "read_specific_endpoint",
+                description: "Reads a specific endpoint and method from an OpenAPI spec (YAML/JSON) or Markdown doc. Optimizes output to save tokens.",
+                inputSchema: {
+                    type: "object",
+                    properties: {
+                        filepath: {
+                            type: "string",
+                            description: "Relative path to the YAML/JSON/MD spec file inside the repo",
+                        },
+                        endpointPath: {
+                            type: "string",
+                            description: "The API path (e.g., '/v1/account/work-information')",
+                        },
+                        method: {
+                            type: "string",
+                            description: "The HTTP method (e.g., 'get', 'post', 'put', 'delete')",
+                        },
+                    },
+                    required: ["filepath", "endpointPath", "method"],
+                },
+            },
             {
                 name: "list_directory",
-                description: "List files and folders in a specific directory inside repository. Use this to find the exact filename before reading.",
+                description: "List files and folders in a specific directory. Limits output to prevent context blowout.",
                 inputSchema: {
                     type: "object",
                     properties: {
@@ -50,13 +186,13 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
             },
             {
                 name: "search_files",
-                description: "Search for files across the entire repository using a keyword (e.g., 'address', 'account'). Use this to find the exact filepath before reading.",
+                description: "Search for files across the repo using a keyword. Limits results to prevent context blowout.",
                 inputSchema: {
                     type: "object",
                     properties: {
                         keyword: {
                             type: "string",
-                            description: "Keyword to search for in filenames (e.g., 'update-address' or '.http')",
+                            description: "Keyword to search for in filenames (e.g., 'update-address')",
                         },
                     },
                     required: ["keyword"],
@@ -66,19 +202,37 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
     };
 });
 async function handleReadApiSpec(args) {
-    const filepath = typeof args?.filepath === "string" ? args.filepath : "";
+    const { filepath, startLine, endLine } = args;
     if (!filepath) {
-        throw new Error("filepath is required and must be a string");
+        throw new Error("filepath is required");
     }
     const fullPath = path.resolve(REPO_BASE_PATH, filepath);
     if (!fullPath.startsWith(REPO_BASE_PATH)) {
-        console.error(`[Security Warning] Attempted path traversal: ${filepath}`);
         throw new Error("Access denied: File is outside the repository base path.");
     }
     try {
+        const stats = await fs.stat(fullPath);
+        if (stats.size > MAX_FILE_SIZE_BYTES && !startLine && !endLine) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `File is too large (${Math.round(stats.size / 1024)}KB). Please use 'read_specific_endpoint' for API specs or specify 'startLine' and 'endLine' to read specific segments.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
         const content = await fs.readFile(fullPath, "utf-8");
+        let resultText = content;
+        if (startLine || endLine) {
+            const lines = content.split("\n");
+            const start = startLine ? Math.max(0, startLine - 1) : 0;
+            const end = endLine ? Math.min(lines.length, endLine) : lines.length;
+            resultText = lines.slice(start, end).join("\n");
+        }
         return {
-            content: [{ type: "text", text: content }],
+            content: [{ type: "text", text: resultText }],
         };
     }
     catch (error) {
@@ -88,6 +242,102 @@ async function handleReadApiSpec(args) {
         };
     }
 }
+async function handleReadSpecificEndpoint(args) {
+    const { filepath, endpointPath, method } = args;
+    if (!filepath || !endpointPath || !method) {
+        throw new Error("filepath, endpointPath, and method are required");
+    }
+    const fullPath = path.resolve(REPO_BASE_PATH, filepath);
+    if (!fullPath.startsWith(REPO_BASE_PATH)) {
+        throw new Error("Access denied: File is outside the repository base path.");
+    }
+    const ext = path.extname(filepath).toLowerCase();
+    try {
+        const content = await fs.readFile(fullPath, "utf-8");
+        if (ext === ".md" || ext === ".markdown") {
+            const sections = content.split(/^# /m);
+            const lowPath = endpointPath.toLowerCase();
+            const lowMethod = method.toLowerCase();
+            const matches = sections.filter((s) => {
+                const lowSection = s.toLowerCase();
+                const hasMethod = lowSection.includes(`[${lowMethod}]`) ||
+                    lowSection.includes(`**${lowMethod}**`) ||
+                    lowSection.includes(`${lowMethod} `) ||
+                    lowSection.includes(`| ${lowMethod} `);
+                return hasMethod && lowSection.includes(lowPath);
+            });
+            if (matches.length === 0) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `No matching section found for "${method} ${endpointPath}" in Markdown file.`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+            const result = matches
+                .map((m) => (m.trim() ? `# ${m.trim()}` : ""))
+                .join("\n\n---\n\n");
+            return {
+                content: [{ type: "text", text: optimizeMarkdown(result) }],
+            };
+        }
+        const spec = yaml.load(content);
+        if (!spec || typeof spec !== "object") {
+            throw new Error("Invalid spec file format");
+        }
+        const paths = spec.paths || spec.endpoints;
+        if (!paths) {
+            throw new Error("Spec file does not contain 'paths' or 'endpoints' section");
+        }
+        const lowPath = endpointPath.toLowerCase();
+        const actualPathKey = Object.keys(paths).find((k) => k.toLowerCase() === lowPath);
+        if (!actualPathKey) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Endpoint path "${endpointPath}" not found in spec.`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const pathObj = paths[actualPathKey];
+        const lowMethod = method.toLowerCase();
+        const actualMethodKey = Object.keys(pathObj).find((m) => m.toLowerCase() === lowMethod);
+        if (!actualMethodKey) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Method "${method}" not found for path "${endpointPath}".`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+        const prunedMethodObj = pruneOpenApiObject(pathObj[actualMethodKey]);
+        const result = {
+            [actualPathKey]: {
+                [actualMethodKey]: prunedMethodObj,
+            },
+        };
+        return {
+            content: [{ type: "text", text: yaml.dump(result) }],
+        };
+    }
+    catch (error) {
+        return {
+            content: [
+                { type: "text", text: `Error processing spec: ${error.message}` },
+            ],
+            isError: true,
+        };
+    }
+}
 async function handleListDirectory(args) {
     const dirPath = typeof args?.dirPath === "string" ? args.dirPath : ".";
     const fullDirPath = path.resolve(REPO_BASE_PATH, dirPath);
@@ -96,11 +346,21 @@ async function handleListDirectory(args) {
     }
     try {
         const files = await fs.readdir(fullDirPath, { withFileTypes: true });
-        const fileList = files
-            .map((dirent) => `${dirent.isDirectory() ? "[DIR]" : "[FILE]"} ${dirent.name}`)
-            .join("\n");
+        let fileList = files
+            .filter((d) => !IGNORED_DIRS.includes(d.name))
+            .map((dirent) => `${dirent.isDirectory() ? "[DIR]" : "[FILE]"} ${dirent.name}`);
+        const total = fileList.length;
+        if (fileList.length > MAX_LIST_ENTRIES) {
+            fileList = fileList.slice(0, MAX_LIST_ENTRIES);
+            fileList.push(`\n... and ${total - MAX_LIST_ENTRIES} more entries.`);
+        }
         return {
-            content: [{ type: "text", text: `Contents of ${dirPath}:\n${fileList}` }],
+            content: [
+                {
+                    type: "text",
+                    text: `Contents of ${dirPath}:\n${fileList.join("\n")}`,
+                },
+            ],
         };
     }
     catch (error) {
@@ -116,17 +376,15 @@ async function findFilesRecursive(dir, keyword, basePath) {
     let results = [];
     const list = await fs.readdir(dir, { withFileTypes: true });
     for (const file of list) {
-        if (file.isDirectory() &&
-            (file.name === "node_modules" ||
-                file.name === ".git" ||
-                file.name === ".idea" ||
-                file.name === ".vscode")) {
+        if (file.isDirectory() && IGNORED_DIRS.includes(file.name)) {
             continue;
         }
         const fullPath = path.resolve(dir, file.name);
         if (file.isDirectory()) {
             const subResults = await findFilesRecursive(fullPath, keyword, basePath);
             results = results.concat(subResults);
+            if (results.length > MAX_SEARCH_RESULTS)
+                break;
         }
         else if (file.name.toLowerCase().includes(keyword.toLowerCase())) {
             results.push(path.relative(basePath, fullPath));
@@ -137,10 +395,16 @@ async function findFilesRecursive(dir, keyword, basePath) {
 async function handleSearchFiles(args) {
     const keyword = typeof args?.keyword === "string" ? args.keyword : "";
     if (!keyword) {
-        throw new Error("keyword is required and must be a string");
+        throw new Error("keyword is required");
     }
     try {
-        const matchedFiles = await findFilesRecursive(REPO_BASE_PATH, keyword, REPO_BASE_PATH);
+        let matchedFiles = await findFilesRecursive(REPO_BASE_PATH, keyword, REPO_BASE_PATH);
+        const total = matchedFiles.length;
+        let warning = "";
+        if (matchedFiles.length > MAX_SEARCH_RESULTS) {
+            matchedFiles = matchedFiles.slice(0, MAX_SEARCH_RESULTS);
+            warning = `\n\nWarning: Showing first ${MAX_SEARCH_RESULTS} of ${total} results. Please use a more specific keyword.`;
+        }
         if (matchedFiles.length === 0) {
             return {
                 content: [
@@ -155,7 +419,7 @@ async function handleSearchFiles(args) {
             content: [
                 {
                     type: "text",
-                    text: `Found ${matchedFiles.length} matching files:\n${matchedFiles.join("\n")}`,
+                    text: `Found ${matchedFiles.length} matching files:\n${matchedFiles.join("\n")}${warning}`,
                 },
             ],
         };
@@ -174,6 +438,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     switch (name) {
         case "read_api_spec":
             return await handleReadApiSpec(args);
+        case "read_specific_endpoint":
+            return await handleReadSpecificEndpoint(args);
         case "list_directory":
             return await handleListDirectory(args);
         case "search_files":
@@ -185,7 +451,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 async function run() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    console.error(`MCP Server "acw-repo-reader" is running on stdio.`);
+    console.error(`MCP Server "http-client-mcp-server" is running on stdio.`);
     console.error(`Watching repository path: ${REPO_BASE_PATH}`);
 }
 try {

package/index.ts

@@ -7,24 +7,153 @@ import {
 } from "@modelcontextprotocol/sdk/types.js";
 import fs from "node:fs/promises";
 import path from "node:path";
+import yaml from "js-yaml";
+
+const IGNORED_DIRS = [
+  "node_modules",
+  ".git",
+  ".idea",
+  ".vscode",
+  "dist",
+  "build",
+  ".next",
+  ".cache",
+];
+const MAX_SEARCH_RESULTS = 50;
+const MAX_LIST_ENTRIES = 100;
+const MAX_FILE_SIZE_BYTES = 100 * 1024; // 100KB
+
+function pruneOpenApiObject(obj: any): any {
+  if (!obj || typeof obj !== "object") return obj;
+
+  if (Array.isArray(obj)) {
+    return obj.map(pruneOpenApiObject);
+  }
+
+  const pruned: any = {};
+  const skipKeys = ["description", "summary", "example", "examples"];
+
+  for (const [key, value] of Object.entries(obj)) {
+    if (skipKeys.includes(key) || key.startsWith("x-")) {
+      continue;
+    }
+    pruned[key] = pruneOpenApiObject(value);
+  }
+  return pruned;
+}
+
+/**
+ * Minifies JSON code blocks in Markdown.
+ */
+function minifyJsonInMarkdown(text: string): string {
+  return text.replace(/```json([\s\S]*?)```/g, (match, jsonStr) => {
+    try {
+      const minified = JSON.stringify(JSON.parse(jsonStr.trim()));
+      return `\`\`\`json\n${minified}\n\`\`\``;
+    } catch {
+      return match;
+    }
+  });
+}
+
+/**
+ * Flattens Markdown tables into concise bulleted lists.
+ */
+function flattenMarkdownTables(text: string): string {
+  const lines = text.split("\n");
+  const result: string[] = [];
+  let inTable = false;
+  let headers: string[] = [];
+
+  for (const line of lines) {
+    const isDivider = /^[\s|:-]+$/.test(line);
+    const isRow = line.trim().startsWith("|") && line.trim().endsWith("|");
+
+    if (isRow && !isDivider) {
+      const cells = line
+        .split("|")
+        .map((c) => c.trim())
+        .filter((c, i, arr) => i > 0 && i < arr.length - 1);
+
+      if (!inTable) {
+        inTable = true;
+        headers = cells;
+        continue;
+      }
+
+      // It's a data row
+      if (cells.length > 0) {
+        const formatted = cells
+          .map((cell, i) => {
+            const header = headers[i] || `col${i}`;
+            return cell ? `${header}: ${cell}` : "";
+          })
+          .filter(Boolean)
+          .join(", ");
+        result.push(`- ${formatted}`);
+      }
+    } else {
+      if (inTable && !isDivider && !isRow) {
+        inTable = false;
+      }
+      if (!isDivider) {
+        result.push(line);
+      }
+    }
+  }
+  return result.join("\n");
+}
+
+function optimizeMarkdown(text: string): string {
+  let optimized = text;
+
+  optimized = optimized.replace(/-- no response --/gi, "");
+  optimized = optimized.replace(/Content-Type: application\/json/gi, "");
+
+  optimized = flattenMarkdownTables(optimized);
+
+  optimized = minifyJsonInMarkdown(optimized);
+
+  const seenBlocks = new Set<string>();
+  optimized = optimized.replace(/```[\s\S]*?```/g, (match) => {
+    const cleaned = match.replace(/\s/g, ""); // canonicalize
+    if (seenBlocks.has(cleaned) && cleaned.length > 50) {
+      return "[Same body as above]";
+    }
+    seenBlocks.add(cleaned);
+    return match;
+  });
+
+  optimized = optimized.replace(/\n\s*\n\s*\n+/g, "\n\n");
+
+  return optimized.trim();
+}
 
 const rawRepoPath = process.env.REPO_BASE_PATH || process.argv[2];
 
 if (!rawRepoPath) {
   const currentPath = process.cwd();
-  console.error("Error: REPO_BASE_PATH environment variable or a command-line argument is required.");
-  console.error(`\nHint: If you want to use the current directory, the absolute path is:\n${currentPath}`);
-  console.error(`\nUsage example:\nacw-repo-reader ${currentPath}`);
+  console.error(
+    "Error: REPO_BASE_PATH environment variable or a command-line argument is required.",
+  );
+  console.error(
+    `\nHint: If you want to use the current directory, the absolute path is:\n${currentPath}`,
+  );
+  console.error(`\nUsage example:\nhttp-client-mcp-server ${currentPath}`);
   console.error("\nTips to find your repository path:");
-  console.error("- macOS: Right-click folder + hold 'Option' key -> Select 'Copy as Pathname'");
-  console.error("- Windows: Shift + Right-click folder -> Select 'Copy as path'");
+  console.error(
+    "- macOS: Right-click folder + hold 'Option' key -> Select 'Copy as Pathname'",
+  );
+  console.error(
+    "- Windows: Shift + Right-click folder -> Select 'Copy as path'",
+  );
   process.exit(1);
 }
 
 const REPO_BASE_PATH = path.resolve(rawRepoPath);
 
 const server = new Server(
-  { name: "acw-repo-reader", version: "1.0.0" },
+  { name: "http-client-mcp-server", version: "1.0.0" },
   { capabilities: { tools: {} } },
 );
 
@@ -34,7 +163,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       {
         name: "read_api_spec",
         description:
-          "Reads API specifications, sequence diagrams, or any files from repository.",
+          "Reads API specifications, source code, or any files. Supports line ranges for large files.",
         inputSchema: {
           type: "object",
           properties: {
@@ -42,14 +171,48 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
               type: "string",
               description: "Relative path to the file inside the repo",
             },
+            startLine: {
+              type: "number",
+              description: "Optional start line number (1-based)",
+            },
+            endLine: {
+              type: "number",
+              description: "Optional end line number (1-based)",
+            },
           },
           required: ["filepath"],
         },
       },
+      {
+        name: "read_specific_endpoint",
+        description:
+          "Reads a specific endpoint and method from an OpenAPI spec (YAML/JSON) or Markdown doc. Optimizes output to save tokens.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            filepath: {
+              type: "string",
+              description:
+                "Relative path to the YAML/JSON/MD spec file inside the repo",
+            },
+            endpointPath: {
+              type: "string",
+              description:
+                "The API path (e.g., '/v1/account/work-information')",
+            },
+            method: {
+              type: "string",
+              description:
+                "The HTTP method (e.g., 'get', 'post', 'put', 'delete')",
+            },
+          },
+          required: ["filepath", "endpointPath", "method"],
+        },
+      },
       {
         name: "list_directory",
         description:
-          "List files and folders in a specific directory inside repository. Use this to find the exact filename before reading.",
+          "List files and folders in a specific directory. Limits output to prevent context blowout.",
         inputSchema: {
           type: "object",
           properties: {
@@ -65,14 +228,14 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       {
         name: "search_files",
         description:
-          "Search for files across the entire repository using a keyword (e.g., 'address', 'account'). Use this to find the exact filepath before reading.",
+          "Search for files across the repo using a keyword. Limits results to prevent context blowout.",
         inputSchema: {
           type: "object",
           properties: {
             keyword: {
               type: "string",
               description:
-                "Keyword to search for in filenames (e.g., 'update-address' or '.http')",
+                "Keyword to search for in filenames (e.g., 'update-address')",
             },
           },
           required: ["keyword"],
@@ -83,23 +246,43 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
 });
 
 async function handleReadApiSpec(args: any) {
-  const filepath = typeof args?.filepath === "string" ? args.filepath : "";
+  const { filepath, startLine, endLine } = args;
 
   if (!filepath) {
-    throw new Error("filepath is required and must be a string");
+    throw new Error("filepath is required");
   }
 
   const fullPath = path.resolve(REPO_BASE_PATH, filepath);
-
   if (!fullPath.startsWith(REPO_BASE_PATH)) {
-    console.error(`[Security Warning] Attempted path traversal: ${filepath}`);
     throw new Error("Access denied: File is outside the repository base path.");
   }
 
   try {
+    const stats = await fs.stat(fullPath);
+    if (stats.size > MAX_FILE_SIZE_BYTES && !startLine && !endLine) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `File is too large (${Math.round(stats.size / 1024)}KB). Please use 'read_specific_endpoint' for API specs or specify 'startLine' and 'endLine' to read specific segments.`,
+          },
+        ],
+        isError: true,
+      };
+    }
+
     const content = await fs.readFile(fullPath, "utf-8");
+    let resultText = content;
+
+    if (startLine || endLine) {
+      const lines = content.split("\n");
+      const start = startLine ? Math.max(0, startLine - 1) : 0;
+      const end = endLine ? Math.min(lines.length, endLine) : lines.length;
+      resultText = lines.slice(start, end).join("\n");
+    }
+
     return {
-      content: [{ type: "text", text: content }],
+      content: [{ type: "text", text: resultText }],
     };
   } catch (error: any) {
     return {
@@ -109,6 +292,127 @@ async function handleReadApiSpec(args: any) {
   }
 }
 
+async function handleReadSpecificEndpoint(args: any) {
+  const { filepath, endpointPath, method } = args;
+
+  if (!filepath || !endpointPath || !method) {
+    throw new Error("filepath, endpointPath, and method are required");
+  }
+
+  const fullPath = path.resolve(REPO_BASE_PATH, filepath);
+  if (!fullPath.startsWith(REPO_BASE_PATH)) {
+    throw new Error("Access denied: File is outside the repository base path.");
+  }
+
+  const ext = path.extname(filepath).toLowerCase();
+
+  try {
+    const content = await fs.readFile(fullPath, "utf-8");
+
+    if (ext === ".md" || ext === ".markdown") {
+      const sections = content.split(/^# /m);
+      const lowPath = endpointPath.toLowerCase();
+      const lowMethod = method.toLowerCase();
+
+      const matches = sections.filter((s) => {
+        const lowSection = s.toLowerCase();
+        const hasMethod =
+          lowSection.includes(`[${lowMethod}]`) ||
+          lowSection.includes(`**${lowMethod}**`) ||
+          lowSection.includes(`${lowMethod} `) ||
+          lowSection.includes(`| ${lowMethod} `);
+
+        return hasMethod && lowSection.includes(lowPath);
+      });
+
+      if (matches.length === 0) {
+        return {
+          content: [
+            {
+              type: "text",
+              text: `No matching section found for "${method} ${endpointPath}" in Markdown file.`,
+            },
+          ],
+          isError: true,
+        };
+      }
+
+      const result = matches
+        .map((m) => (m.trim() ? `# ${m.trim()}` : ""))
+        .join("\n\n---\n\n");
+
+      return {
+        content: [{ type: "text", text: optimizeMarkdown(result) }],
+      };
+    }
+
+    const spec = yaml.load(content) as any;
+    if (!spec || typeof spec !== "object") {
+      throw new Error("Invalid spec file format");
+    }
+
+    const paths = spec.paths || spec.endpoints;
+    if (!paths) {
+      throw new Error(
+        "Spec file does not contain 'paths' or 'endpoints' section",
+      );
+    }
+
+    const lowPath = endpointPath.toLowerCase();
+    const actualPathKey = Object.keys(paths).find(
+      (k) => k.toLowerCase() === lowPath,
+    );
+
+    if (!actualPathKey) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Endpoint path "${endpointPath}" not found in spec.`,
+          },
+        ],
+        isError: true,
+      };
+    }
+
+    const pathObj = paths[actualPathKey];
+    const lowMethod = method.toLowerCase();
+    const actualMethodKey = Object.keys(pathObj).find(
+      (m) => m.toLowerCase() === lowMethod,
+    );
+
+    if (!actualMethodKey) {
+      return {
+        content: [
+          {
+            type: "text",
+            text: `Method "${method}" not found for path "${endpointPath}".`,
+          },
+        ],
+        isError: true,
+      };
+    }
+
+    const prunedMethodObj = pruneOpenApiObject(pathObj[actualMethodKey]);
+    const result = {
+      [actualPathKey]: {
+        [actualMethodKey]: prunedMethodObj,
+      },
+    };
+
+    return {
+      content: [{ type: "text", text: yaml.dump(result) }],
+    };
+  } catch (error: any) {
+    return {
+      content: [
+        { type: "text", text: `Error processing spec: ${error.message}` },
+      ],
+      isError: true,
+    };
+  }
+}
+
 async function handleListDirectory(args: any) {
   const dirPath = typeof args?.dirPath === "string" ? args.dirPath : ".";
   const fullDirPath = path.resolve(REPO_BASE_PATH, dirPath);
@@ -119,15 +423,26 @@ async function handleListDirectory(args: any) {
 
   try {
     const files = await fs.readdir(fullDirPath, { withFileTypes: true });
-    const fileList = files
+    let fileList = files
+      .filter((d) => !IGNORED_DIRS.includes(d.name))
       .map(
         (dirent) =>
           `${dirent.isDirectory() ? "[DIR]" : "[FILE]"} ${dirent.name}`,
-      )
-      .join("\n");
+      );
+
+    const total = fileList.length;
+    if (fileList.length > MAX_LIST_ENTRIES) {
+      fileList = fileList.slice(0, MAX_LIST_ENTRIES);
+      fileList.push(`\n... and ${total - MAX_LIST_ENTRIES} more entries.`);
+    }
 
     return {
-      content: [{ type: "text", text: `Contents of ${dirPath}:\n${fileList}` }],
+      content: [
+        {
+          type: "text",
+          text: `Contents of ${dirPath}:\n${fileList.join("\n")}`,
+        },
+      ],
     };
   } catch (error: any) {
     return {
@@ -148,13 +463,7 @@ async function findFilesRecursive(
   const list = await fs.readdir(dir, { withFileTypes: true });
 
   for (const file of list) {
-    if (
-      file.isDirectory() &&
-      (file.name === "node_modules" ||
-        file.name === ".git" ||
-        file.name === ".idea" ||
-        file.name === ".vscode")
-    ) {
+    if (file.isDirectory() && IGNORED_DIRS.includes(file.name)) {
       continue;
     }
 
@@ -163,6 +472,7 @@ async function findFilesRecursive(
     if (file.isDirectory()) {
       const subResults = await findFilesRecursive(fullPath, keyword, basePath);
       results = results.concat(subResults);
+      if (results.length > MAX_SEARCH_RESULTS) break;
     } else if (file.name.toLowerCase().includes(keyword.toLowerCase())) {
       results.push(path.relative(basePath, fullPath));
     }
@@ -174,16 +484,23 @@ async function handleSearchFiles(args: any) {
   const keyword = typeof args?.keyword === "string" ? args.keyword : "";
 
   if (!keyword) {
-    throw new Error("keyword is required and must be a string");
+    throw new Error("keyword is required");
   }
 
   try {
-    const matchedFiles = await findFilesRecursive(
+    let matchedFiles = await findFilesRecursive(
       REPO_BASE_PATH,
       keyword,
       REPO_BASE_PATH,
     );
 
+    const total = matchedFiles.length;
+    let warning = "";
+    if (matchedFiles.length > MAX_SEARCH_RESULTS) {
+      matchedFiles = matchedFiles.slice(0, MAX_SEARCH_RESULTS);
+      warning = `\n\nWarning: Showing first ${MAX_SEARCH_RESULTS} of ${total} results. Please use a more specific keyword.`;
+    }
+
     if (matchedFiles.length === 0) {
       return {
         content: [
@@ -199,7 +516,7 @@ async function handleSearchFiles(args: any) {
       content: [
         {
           type: "text",
-          text: `Found ${matchedFiles.length} matching files:\n${matchedFiles.join("\n")}`,
+          text: `Found ${matchedFiles.length} matching files:\n${matchedFiles.join("\n")}${warning}`,
         },
       ],
     };
@@ -219,6 +536,8 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
   switch (name) {
     case "read_api_spec":
       return await handleReadApiSpec(args);
+    case "read_specific_endpoint":
+      return await handleReadSpecificEndpoint(args);
     case "list_directory":
       return await handleListDirectory(args);
     case "search_files":
@@ -231,7 +550,7 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 async function run() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
-  console.error(`MCP Server "acw-repo-reader" is running on stdio.`);
+  console.error(`MCP Server "http-client-mcp-server" is running on stdio.`);
   console.error(`Watching repository path: ${REPO_BASE_PATH}`);
 }
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "http-client-mcp-server",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "MCP server to explore and read files from a repository",
   "main": "index.js",
   "bin": {
@@ -16,9 +16,11 @@
   "license": "ISC",
   "type": "module",
   "dependencies": {
-    "@modelcontextprotocol/sdk": "^1.29.0"
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "js-yaml": "^4.1.1"
   },
   "devDependencies": {
+    "@types/js-yaml": "^4.0.9",
     "@types/node": "^25.5.2",
     "typescript": "^6.0.2"
   }