KS-GEN-AI/Web-Request-MCP-Server

Web Request MCP Server

Execute HTTP requests via MCP (Model Context Protocol)

This is a TypeScript-based MCP server that provides a flexible tool to execute HTTP requests with custom methods, headers, and body content. It enables AI assistants to interact with web APIs and endpoints seamlessly.

Features

http_request

A versatile tool for making HTTP requests with full control over all parameters.

• Purpose: Execute HTTP requests with custom configuration
• Parameters:
  • url (required): The target URL (e.g., "https://api.example.com/endpoint")
  • method (optional): HTTP method - GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS (defaults to GET)
  • headers (optional): Custom headers as key-value pairs
  • body (optional): Request body (string or object, automatically JSON stringified for objects)
  • params (optional): URL query parameters as key-value pairs
• Behavior:
  • Automatic Content-Type detection for JSON bodies
  • Response truncation for large responses (max 50,000 characters)
  • Comprehensive error handling with status codes
  • Returns full response including status, headers, and data

Example requests:

// Simple GET request
{ url: "https://api.github.com/users/octocat" }

// POST with JSON body
{
  url: "https://api.example.com/data",
  method: "POST",
  headers: { "Authorization": "Bearer token123" },
  body: { name: "John", email: "john@example.com" }
}

// GET with query parameters
{
  url: "https://api.example.com/search",
  params: { q: "search term", limit: "10" }
}

Development

Install dependencies:

npm install

Build the server:

npm run build

For development with auto-rebuild:

npm run watch

Installation

Using with Claude Desktop

To use with Claude Desktop, add the server config:

On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json On Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "webrequest": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/webrequest-mcp-server/build/index.js"]
    }
  }
}

Using with Cursor

Add to your Cursor MCP settings configuration file:

{
  "mcpServers": {
    "webrequest": {
      "command": "node",
      "args": ["/ABSOLUTE/PATH/TO/webrequest-mcp-server/build/index.js"]
    }
  }
}

Debugging

Since MCP servers communicate over stdio, debugging can be challenging. We recommend using the MCP Inspector:

npm run inspector

The Inspector will provide a URL to access debugging tools in your browser.

Configuration

The server configuration:

• Max response size: 50,000 characters (responses larger than this are truncated)
• Supported methods: GET, POST, PUT, DELETE, PATCH, HEAD, OPTIONS
• Content types: Automatic JSON handling, supports any content type via headers

Use Cases

This MCP server is useful for:

• Testing and interacting with REST APIs
• Fetching data from web services
• Automating HTTP requests in AI workflows
• Prototyping API integrations
• Debugging web endpoints

License

MIT License - see LICENSE file for details