Whistle MCP Server

English | 中文

项目介绍

Whistle MCP Server 是一个基于模型上下文协议 (MCP) 的 Whistle 代理管理工具，允许 AI 助手直接操作和控制本地 Whistle 代理服务器。通过此工具，AI 可以帮助用户管理规则、分组、值、监控网络请求、重放和修改请求等，而无需手动操作 Whistle 界面。它极大地简化了网络调试、API 测试和代理规则管理的流程，使用户能够通过与 AI 的自然语言交互来完成复杂的网络代理配置任务。

Related MCP server: MCP Server

功能特性

• 规则管理：创建、更新、重命名、删除以及启用/禁用 Whistle 规则

• 分组管理：创建、重命名、删除分组，以及规则与分组之间的关联操作

• 值管理：创建、更新、重命名和删除值，支持值分组管理

• 代理控制：启用/禁用代理、HTTP/HTTPS 拦截、HTTP/2 协议等

• 请求拦截：查看拦截的网络请求信息，支持 URL 过滤

• 请求重放：支持使用自定义请求参数重放捕获的请求

• 多规则模式：支持启用/禁用多规则模式

安装

要求

需要 Node.js 18.20.0 或更高版本（请参阅 package.json 中的 engines）。不支持旧版本。

通过 Smithery 安装

通过 Smithery 自动为 Claude Desktop 安装 Whistle MCP Server：

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

手动安装

你可以通过 npm 全局安装 Whistle MCP Server：

npm install -g whistle-mcp-tool

从源码构建

在仓库根目录下：

npm install
npm run build

构建输出入口为 dist/index.js（与全局安装后 whistle-mcp CLI 使用的文件相同）。你也可以通过 node 和 dist/index.js 的路径将其指向 MCP 配置。

MCP 配置

传输方式 (stdio vs HTTP)

默认情况下，服务器使用 stdio（适用于 Cursor 等本地 MCP 客户端）。

要在同一进程上公开 Streamable HTTP 和 SSE（用于远程或支持 HTTP 的客户端），请使用 --transport http-stream。FastMCP 将监听 --mcp-host / --mcp-port 并提供以下服务：

• Streamable HTTP: http://<mcp-host>:<mcp-port><mcp-endpoint>（默认路径 /mcp）

• SSE: http://<mcp-host>:<mcp-port>/sse

http-stream 的别名：sse，streamable-http（模式相同；两个 URL 均可用）。

Whistle 连接选项保持不变：--host、--port、--username / --password（或 -n / -w）。

示例（HTTP 传输 + 本地 Whistle 在 8899 端口；MCP 默认监听 8085）：

whistle-mcp --transport http-stream --host 127.0.0.1 --port 8899

使用 --mcp-port <port> 覆盖默认的 8085。

安装后，你可以在 MCP JSON 配置文件中配置 Whistle MCP：

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

如果你在启动 Whistle 时使用了基本身份验证（与 Whistle CLI 标志相同：w2 start -n <username> -w <password>），请将相同的凭据传递给此 MCP 服务器，以便对 Whistle API 的 HTTP 请求能够成功：

{
  "mcpServers": {
    "whistle-mcp": {
      "command": "whistle-mcp",
      "args": [
        "--host=localhost",
        "--port=8899",
        "--username=<username>",
        "--password=<password>"
      ]
    }
  }
}

短选项（与 w2 对齐）：-n / -w 等同于 --username / --password。

whistle-mcp --host localhost --port 8899 -n myuser -w mypass

配置详情

• host: Whistle 服务器 IP 地址；如果省略，默认为 localhost

• port: Whistle 服务器端口；如果省略，默认为 8899

• username (-n / --username): 使用 -n 启动 Whistle 时的基本身份验证用户名；如果 Whistle 没有登录，则省略

• password (-w / --password): 使用 -w 启动 Whistle 时的基本身份验证密码；如果设置了用户名但省略了密码，则发送空密码

在 AI 客户端中配置 MCP JSON

• Claude 客户端: https://modelcontextprotocol.io/quickstart/user

• Raycast: 需要安装 MCP 插件

• Cursor: https://docs.cursor.com/context/model-context-protocol#configuring-mcp-servers

MCP 工具说明

Whistle MCP Server 提供以下工具，可通过 MCP 协议调用：

规则管理

分组管理

值管理

代理控制

请求管理

工具类

联系方式

• 邮箱: gz7gugu@qq.com

• 博客: https://7gugu.com