whistle-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@whistle-mcp帮我创建一个Mock,请求 api.example.com/user/info 时返回张三的信息"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
whistle-mcp
MCP (Model Context Protocol) Server for whistle - 让 AI 直接操作 whistle 的 Mock 数据。
安装
# 全局安装(推荐)
npm install -g whistle-mcp
# 或直接用 npx,无需安装
npx whistle-mcpRelated MCP server: Whissle MCP Server
配置
方式一:Cursor
编辑 Cursor 的 MCP 配置文件(~/.cursor/mcp.json):
{
"mcpServers": {
"whistle": {
"command": "npx",
"args": ["-y", "whistle-mcp"],
"env": {
"WHISTLE_BASE_URL": "http://127.0.0.1:8899",
"WHISTLE_USERNAME": "",
"WHISTLE_PASSWORD": ""
}
}
}
}全局安装后也可以写成:
{
"mcpServers": {
"whistle": {
"command": "whistle-mcp",
"env": {
"WHISTLE_BASE_URL": "http://127.0.0.1:8899"
}
}
}
}方式二:Claude Desktop
编辑 ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) 或 %APPDATA%\Claude\claude_desktop_config.json (Windows):
{
"mcpServers": {
"whistle": {
"command": "npx",
"args": ["-y", "whistle-mcp"],
"env": {
"WHISTLE_BASE_URL": "http://127.0.0.1:8899",
"WHISTLE_USERNAME": "",
"WHISTLE_PASSWORD": ""
}
}
}
}如果 whistle 启用了鉴权(
w2 start -u admin -p 123456),请填写WHISTLE_USERNAME和WHISTLE_PASSWORD。
方式三:其他 MCP 客户端
任何支持 stdio 传输的 MCP 客户端都可以使用:
WHISTLE_BASE_URL=http://127.0.0.1:8899 \
WHISTLE_USERNAME=admin \
WHISTLE_PASSWORD=123456 \
npx -y whistle-mcp功能
规则管理
whistle_rule_list- 获取所有规则列表whistle_rule_get- 获取规则内容whistle_rule_set- 创建/更新规则whistle_rule_remove- 删除规则whistle_rule_enable/whistle_rule_disable- 启用/禁用规则
Values 管理
whistle_value_list- 获取所有 Valueswhistle_value_get- 获取 Value 内容whistle_value_set- 创建/更新 Valuewhistle_value_remove- 删除 Value
Mock 工作流
whistle_mock_create- 一键创建完整 Mock 方案(规则 + Values)whistle_mock_apply- 启用/禁用 Mock 规则
抓包数据查看
whistle_sessions_list- 获取最近抓包的 session 列表,可按 URL / HTTP 方法过滤whistle_session_get- 获取单个请求的完整详情,自动解析 Query 参数、POST 参数和响应 JSON 字段树whistle_sessions_search- 按请求参数名(query/POST body)或响应 JSON 字段名搜索抓包,例如"哪些请求带了 token 参数"、"哪些接口返回了 address 字段"
系统状态
whistle_status- 检查 whistle 服务状态whistle_server_info- 获取服务器信息
环境变量
变量 | 默认值 | 说明 |
| 自动探测 | whistle Web UI 地址。不设置时会自动读取 |
| `` | whistle 鉴权用户名(可选) |
| `` | whistle 鉴权密码(可选) |
端口自动探测
MCP Server 启动时会自动检测运行中的 whistle 实例(不管用什么端口启动),优先级:
环境变量
WHISTLE_BASE_URL(显式指定,最高优先级)whistle 状态文件
~/.startingAppData/(自动探测)默认
http://127.0.0.1:8899(fallback)
所以即使你 w2 start -p 8888 用别的端口启动,也能自动识别,无需改配置。
使用示例
1. 创建 Mock 接口
AI 指令:
帮我创建一个 Mock,当请求
api.example.com/user/info时返回用户数据
AI 会调用:
{
"tool": "whistle_mock_create",
"arguments": {
"pattern": "api.example.com/user/info",
"response": {
"code": 200,
"data": {
"id": 12345,
"name": "张三",
"email": "zhangsan@example.com"
}
},
"statusCode": 200,
"delay": 100
}
}2. 管理规则
AI 指令:
列出所有 whistle 规则
AI 会调用:
{
"tool": "whistle_rule_list"
}3. 更新 Mock 数据
AI 指令:
把用户 Mock 数据里的邮箱改成 lisi@example.com
AI 会调用:
{
"tool": "whistle_value_set",
"arguments": {
"name": "mock_value_1234567890",
"content": "{\"statusCode\":200,\"headers\":{\"Content-Type\":\"application/json\"},\"body\":{\"code\":200,\"data\":{\"id\":12345,\"name\":\"张三\",\"email\":\"lisi@example.com\"}}}"
}
}4. 查看抓包数据
AI 指令:
帮我看看最近有没有抓到 api.vip.com 的请求
AI 会调用:
{
"tool": "whistle_sessions_list",
"arguments": {
"urlFilter": "api.vip.com",
"count": 10
}
}AI 指令:
查看最后一个请求的完整响应数据
AI 会调用:
{
"tool": "whistle_session_get",
"arguments": {
"id": "abc123-def456"
}
}5. 按参数/字段搜索抓包
AI 指令:
查一下最近有没有请求带了 userId 参数
AI 会调用:
{
"tool": "whistle_sessions_search",
"arguments": {
"param": "userId",
"count": 50
}
}AI 指令:
看看最近 POST 到 api.vip.com 的接口,返回的数据里有没有 address 字段
AI 会调用:
{
"tool": "whistle_sessions_search",
"arguments": {
"urlFilter": "api.vip.com",
"method": "POST",
"field": "address",
"count": 50
}
}前置条件
whistle 已安装并运行:
npm i -g whistle w2 start确认 whistle Web UI 可访问:
curl http://127.0.0.1:8899/cgi-bin/status
架构
┌─────────────┐ MCP (stdio) ┌──────────────────┐ HTTP ┌─────────────┐
│ AI Client │ ◄──────────────────► │ whistle-mcp-server│ ◄─────────────► │ whistle │
│ (Claude/ │ │ (Node.js) │ │ (127.0.0.1 │
│ Cursor) │ │ │ │ :8899) │
└─────────────┘ └──────────────────┘ └─────────────┘
│
▼
┌─────────────┐
│ ~/.whistle/ │
│ rules/ │
│ values/ │
└─────────────┘开发
本地测试
# 启动 whistle
w2 start
# 启动 MCP Server(开发模式)
npm run dev
# 测试 MCP 协议
echo '{"jsonrpc":"2.0","id":1,"method":"tools/list"}' | node src/index.js调试
查看 whistle Web UI 的 CGI 接口:
# 规则列表
curl http://127.0.0.1:8899/cgi-bin/rules/list
# Values 列表
curl http://127.0.0.1:8899/cgi-bin/values/listLicense
MIT
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Servers
- AlicenseCqualityCmaintenanceWhistle MCP Server is a Whistle proxy management tool based on the Model Context Protocol (MCP) protocol, which enables AI assistants to directly operate and control local Whistle proxy servers. Through this tool, AI can help users manage rules, groups, values, monitor network requests, and replay aLast updated324442MIT
- FlicenseAquality-maintenanceProvides access to Whissle AI services for speech-to-text, speaker diarization, translation, and text summarization. It enables users to process various audio formats and manage text content through natural language tools.Last updated5
- FlicenseBqualityDmaintenanceEnables AI assistants to configure and manage session-based REST and WebSocket mock servers for application development and testing. It allows for dynamic endpoint setup, request history inspection, and real-time WebSocket communication through natural language commands.Last updated8
- Alicense-qualityDmaintenanceEnables AI assistants to interact with Magic-API development environment, supporting script syntax query, API management, debugging, and knowledge search for efficient development.Last updatedMIT
Related MCP Connectors
Live browser debugging for AI assistants — DOM, console, network via MCP.
Create, test, publish, and manage Dreamlit notification workflows from AI clients.
AI-powered design and management for Webflow Sites
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/hzbhzb/whistle-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server