代理服务器管理工具

Whistle MCP服务器

英语| 中文

项目介绍

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

特性

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

安装

需求

需要Node.js 18.20.0或更高版本 （参见 engines 在 package.json).不支持旧版本。

通过Smithery安装

通过以下方式自动安装适用于Claude Desktop的Whistle MCP服务器 铁匠铺:

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

手动安装

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

npm install -g whistle-mcp-tool

从源代码构建

从存储库根目录：

npm install
npm run build

构建输出条目为 dist/index.js （与使用的文件相同 whistle-mcp 全局安装后的CLI）。您还可以将MCP配置指向它 node 以及通往 dist/index.js.

MCP配置

传输（标准传输与HTTP）

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

暴露 可流式传输的HTTP 和 上海证券交易所 在同一进程上（对于远程或支持HTTP的客户端），使用 --transport http-stream.FastMCP然后继续监听 --mcp-host / --mcp-port 并提供：

• 流式HTTP： http://<mcp-host>:<mcp-port><mcp-endpoint> （默认路径 /mcp)
• 上海证券交易所 http://<mcp-host>:<mcp-port>/sse

别名为 http-stream: sse, streamable-http （模式相同；两个URL都可用）。

哨子 连接选项不变： --host, --port, --username / --password （或 -n / -w).

示例（8899上的HTTP传输+本地Whistle；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 CLI相同的标志）启动Whistle： 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

配置详情

• 主机：Whistle服务器IP地址；默认为 localhost 如果省略
• 端口：Whistle服务器端口；默认为 8899 如果省略
• 用户名 (-n / --username)：Whistle启动时的基本身份验证用户名 -n；如果Whistle没有登录名，则省略
• 密码 (-w / --password)：Whistle启动时的基本身份验证密码 -w；如果设置了用户名但省略了密码，则会发送一个空密码

在AI客户端中配置MCP JSON

• 克劳德客户： https://modelcontextprotocol.io/quickstart/user
• Raycast：需要安装MCP插件
• 光标： https://docs.cursor.com/context/model-context-protocol#configuring-mcp服务器

MCP工具说明

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

规则管理

组管理

价值管理

代理控制

请求管理

效用

联系方式

• 电子邮件： gz7gugu@qq.com
• 博客： https://7gugu.com