Curl MCP Server

Instructions

Implementation Reference

• src/index.ts:366-418 (handler)

  The handler function that executes the curl download logic by building safe curl arguments and invoking the shared executeCurl helper.

  async ({ url, output_filename, resume, follow_redirects, timeout }) => {
    const args = ['curl'];
    
    // Add the URL
    args.push(url);
    
    // Add output option
    if (output_filename) {
      args.push('-o', output_filename);
    } else {
      args.push('-O'); // Use remote filename
    }
    
    // Add resume option
    if (resume) {
      args.push('-C', '-');
    }
    
    // Add follow redirects option
    if (follow_redirects) {
      args.push('-L');
    }
    
    // Add timeout if provided
    if (timeout) {
      args.push('--max-time', timeout.toString());
    }
    
    // Show progress
    args.push('--progress-bar');
    
    try {
      const result = await executeCurl(args);
      
      return {
        content: [
          {
            type: "text",
            text: `Exit Code: ${result.exitCode}\n\nDownload ${result.exitCode === 0 ? 'completed successfully' : 'failed'}:\n${result.stdout}${result.stderr ? `\n\nOutput:\n${result.stderr}` : ''}`,
          },
        ],
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error executing curl: ${error instanceof Error ? error.message : String(error)}`,
          },
        ],
      };
    }
  }

• src/index.ts:359-365 (schema)

  Zod input schema defining the parameters for the curl_download tool.

  {
    url: z.string().describe("The URL of the file to download"),
    output_filename: z.string().optional().describe("Output filename (if not provided, will use remote filename)"),
    resume: z.boolean().optional().default(false).describe("Resume partial download if file exists"),
    follow_redirects: z.boolean().optional().default(true).describe("Whether to follow redirects"),
    timeout: z.number().optional().describe("Request timeout in seconds"),
  },

• src/index.ts:356-419 (registration)

  The server.tool registration for the curl_download tool, including description, schema, and handler reference."},{

  server.tool(
    "curl_download",
    "Download a file using curl",
    {
      url: z.string().describe("The URL of the file to download"),
      output_filename: z.string().optional().describe("Output filename (if not provided, will use remote filename)"),
      resume: z.boolean().optional().default(false).describe("Resume partial download if file exists"),
      follow_redirects: z.boolean().optional().default(true).describe("Whether to follow redirects"),
      timeout: z.number().optional().describe("Request timeout in seconds"),
    },
    async ({ url, output_filename, resume, follow_redirects, timeout }) => {
      const args = ['curl'];
      
      // Add the URL
      args.push(url);
      
      // Add output option
      if (output_filename) {
        args.push('-o', output_filename);
      } else {
        args.push('-O'); // Use remote filename
      }
      
      // Add resume option
      if (resume) {
        args.push('-C', '-');
      }
      
      // Add follow redirects option
      if (follow_redirects) {
        args.push('-L');
      }
      
      // Add timeout if provided
      if (timeout) {
        args.push('--max-time', timeout.toString());
      }
      
      // Show progress
      args.push('--progress-bar');
      
      try {
        const result = await executeCurl(args);
        
        return {
          content: [
            {
              type: "text",
              text: `Exit Code: ${result.exitCode}\n\nDownload ${result.exitCode === 0 ? 'completed successfully' : 'failed'}:\n${result.stdout}${result.stderr ? `\n\nOutput:\n${result.stderr}` : ''}`,
            },
          ],
        };
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `Error executing curl: ${error instanceof Error ? error.message : String(error)}`,
            },
          ],
        };
      }
    }
  );