Whistle MCP Server

English | 中文

项目介绍

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

特性

• 规则管理: 创建、更新、重命名、删除和启用/禁用 Whistle 规则
• 分组管理: 创建、重命名、删除分组，以及关联规则和分组之间的操作
• 值管理: 创建、更新、重命名和删除值，支持值分组管理
• 代理控制: 启用/禁用代理、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-tool",
      "args": [
        "--host=<whistle server IP address>",
        "--port=<whistle server port number>"
      ]
    }
  }
}

配置详情

• host: Whistle 服务器 IP 地址，如果未配置，则默认为 localhost
• port: Whistle 服务器端口号，如果未配置，则默认为 8899

在 AI 客户端中配置 MCP JSON

• Claude Client: 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: gz7gugu@qq.com
• Blog: https://7gugu.com