Whistle MCP 服务器

English |中文

项目介绍

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

特征

规则管理：创建、更新、重命名、删除和启用/禁用 Whistle 规则
群组管理：创建、重命名、删除群组，以及规则与群组之间的关联操作
值管理：创建、更新、重命名和删除值，支持值组管理
代理控制：启用/禁用代理、HTTP/HTTPS拦截、HTTP/2协议等。
请求拦截：查看拦截的网络请求信息，支持URL过滤
请求重放：支持使用自定义请求参数重放捕获的请求
多规则模式：支持启用/禁用多规则模式

安装

通过 Smithery 安装

要通过Smithery自动为 Claude Desktop 安装 Whistle MCP 服务器：

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

手动安装

您可以通过 npm 全局安装 Whistle MCP 服务器：

npm install -g whistle-mcp-tool

MCP 配置

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

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

配置详细信息

host：Whistle 服务器 IP 地址，若未配置则默认为 localhost
port：Whistle 服务器端口号，若未配置则默认为 8899

在 AI 客户端中配置 MCP JSON

Claude 客户端： https://modelcontextprotocol.io/quickstart/user
Raycast：需要安装 MCP 插件
光标： https://docs.cursor.com/context/model-context-protocol#configuring-mcp-servers

MCP 工具说明

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

规则管理

工具名称	描述	功能
获取规则	获取所有规则	列出所有已创建的规则及其内容
创建规则	创建新规则	创建具有指定名称的新规则
更新规则	更新规则内容	修改指定规则的内容
重命名规则	重命名规则	将规则重命名为新名称
删除规则	删除规则	删除指定名称的规则
选择规则	启用规则	启用指定名称的规则
取消选择规则	禁用规则	禁用指定名称的规则
disableAllRules	禁用所有规则	一次性禁用所有已创建的规则

集团管理

工具名称	描述	功能
创建组	创建群组	创建具有指定名称的新规则组
重命名组	重命名组	将规则组重命名为新名称
删除组	删除组	删除指定名称的规则组
moveRuleToGroup	将规则移动到组	将指定规则移动到特定组
moveRuleOutOfGroup	将规则移出组	将规则从其组移至顶层

价值管理

工具名称	描述	功能
获取所有值	获取所有值	列出所有创建的值和值组
创造价值	创造新价值	使用指定名称创建新值
更新值	更新值内容	修改指定值的内容
重命名值	重命名值	将值重命名为新名称
删除值	删除值	删除具有指定名称的值
创建值组	创建价值集团	创建具有指定名称的新值组
重命名值组	重命名值组	将值组重命名为新名称
删除值组	删除值组	删除具有指定名称的值组
moveValueToGroup	将值移动到组	将指定值移动到特定组
moveValueOutOfGroup	将值移出组	将值从其组移至顶层

代理控制

工具名称	描述	功能
获取状态	获取服务器状态	获取Whistle服务器的当前状态信息
切换代理	启用/禁用代理	切换 Whistle 代理的启用状态
切换Https拦截	启用/禁用 HTTPS 拦截	切换 HTTPS 请求拦截的启用状态
切换Http2	启用/禁用 HTTP2	切换 HTTP/2 协议支持的启用状态
切换多规则模式	启用/禁用多规则模式	切换是否允许同时启用多个规则

请求管理

工具名称	描述	功能
获取拦截信息	获取拦截信息	获取Whistle拦截的网络请求信息，并支持过滤
重放请求	重播请求	使用可自定义的参数重新发送指定的网络请求

联系信息

邮箱： gz7gugu@qq.com
博客： https://7gugu.com

whistle-mcp

Integrations