Whistle MCP Server

English | 中文

Project Introduction

Whistle MCP Server is a Whistle proxy management tool based on the Model Context Protocol (MCP), allowing AI assistants to directly operate and control local Whistle proxy servers. Through this tool, AI can help users manage rules, groups, values, monitor network requests, replay and modify requests, etc., without requiring manual operation of the Whistle interface. It greatly simplifies the process of network debugging, API testing, and proxy rule management, enabling users to complete complex network proxy configuration tasks through natural language interaction with AI.

Features

• Rule Management: Create, update, rename, delete, and enable/disable Whistle rules
• Group Management: Create, rename, delete groups, and associate operations between rules and groups
• Value Management: Create, update, rename, and delete values, with support for value group management
• Proxy Control: Enable/disable proxy, HTTP/HTTPS interception, HTTP/2 protocol, etc.
• Request Interception: View intercepted network request information, with URL filtering support
• Request Replay: Support for replaying captured requests with custom request parameters
• Multi-Rule Mode: Support for enabling/disabling multi-rule mode

Installation

Installing via Smithery

To install Whistle MCP Server for Claude Desktop automatically via Smithery:

npx -y @smithery/cli install @7gugu/whistle-mcp --client claude

Manual Installation

You can install Whistle MCP Server globally via npm:

npm install -g whistle-mcp-tool

MCP Configuration

After installation, you can configure Whistle MCP in your MCP JSON configuration file:

{
  "mcpServers": {
    "whistle-mcp": {
      "command": "whistle-mcp",
      "args": [
        "--host=<whistle server IP address>",
        "--port=<whistle server port number>"
      ]
    }
  }
}

Configuration Details

• host: Whistle server IP address, defaults to localhost if not configured
• port: Whistle server port number, defaults to 8899 if not configured

Configuring MCP JSON in AI Clients

• Claude Client: https://modelcontextprotocol.io/quickstart/user
• Raycast: Requires MCP plugin installation
• Cursor: https://docs.cursor.com/context/model-context-protocol#configuring-mcp-servers

MCP Tools Description

Whistle MCP Server provides the following tools, which can be called via the MCP protocol:

Rule Management

Group Management

Value Management

Proxy Control

Request Management

Contact Information

• Email: gz7gugu@qq.com
• Blog: https://7gugu.com