Whistle MCP Server

中文 | English

项目简介

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

功能特点

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

---

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

安装

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

npm install -g whistle-mcp-tool

MCP 配置

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

{
  "mcpServers": {
    "whistle-mcp": {
      "command": "whistle-mcp",
      "args": [
        "--host=<whistle的服务器IP地址>",
        "--port=<whistle的服务器端口号>"
      ]
    }
  }
}

配置说明

• host whistle的服务器IP地址 不配置的时候使用localhost作为默认值
• port whistle的服务器端口号 不配置的时候使用8899作为默认值

将 MCP JSON 配置到 AI 客户端 中

• 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 协议调用：

规则管理

工具名称	描述	功能
getRules	获取所有规则	列出所有已创建的规则及其内容
createRule	创建新规则	新建一个指定名称的规则
updateRule	更新规则内容	修改指定规则的内容
renameRule	重命名规则	将规则重命名为新名称
deleteRule	删除规则	删除指定名称的规则
selectRule	启用规则	启用指定名称的规则
unselectRule	禁用规则	禁用指定名称的规则
disableAllRules	禁用所有规则	一键禁用所有已创建的规则

分组管理

工具名称	描述	功能
createGroup	创建分组	新建一个指定名称的规则分组
renameGroup	重命名分组	将规则分组重命名为新名称
deleteGroup	删除分组	删除指定名称的规则分组
moveRuleToGroup	移动规则到分组	将指定规则移动到特定分组中
moveRuleOutOfGroup	移出规则	将规则从分组中移出到顶层

值管理

工具名称	描述	功能
getAllValues	获取所有值	列出所有已创建的值和值分组
createValue	创建新值	新建一个指定名称的值
updateValue	更新值内容	修改指定值的内容
renameValue	重命名值	将值重命名为新名称
deleteValue	删除值	删除指定名称的值
createValueGroup	创建值分组	新建一个指定名称的值分组
renameValueGroup	重命名值分组	将值分组重命名为新名称
deleteValueGroup	删除值分组	删除指定名称的值分组
moveValueToGroup	移动值到分组	将指定值移动到特定分组中
moveValueOutOfGroup	移出值	将值从分组中移出到顶层

代理控制

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

请求管理

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

联系方式

• 邮箱: [email protected]
• 博客: https://7gugu.com