wave MCP Server

A Model Context Protocol (MCP) server for the wave CLI HTTP client.

This package provides a JavaScript wrapper that downloads and manages the wave binary and exposes its functionality through a stdio MCP server interface.

Usage

npx wave-mcp

The server communicates via stdin/stdout using the MCP protocol, making it compatible with MCP clients like Claude Desktop, OpenAI tools, and other LLM applications.

Available Tools

The MCP server exposes Wave's HTTP functionality through these tools:

• http - Send HTTP request
• collection — Send predefined HTTP request from collection file

Example Tool Usage

{
  "name": "http",
  "arguments": {
    "url": "https://httpbin.org/json",
    "headers": {
      "User-Agent": "my-app/1.0"
    }
  }
}

Binary Management

The server automatically:

• Downloads the latest Wave binary on first run
• Caches the binary at ~/.cache/wave-mcp/
• Updates to newer versions when available
• Supports macOS (x86_64/ARM64) and Linux (x86_64)

Development

npm install
npm start

Requirements

• Node.js 18+
• MCP client (like Claude Desktop)