whistle-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| WHISTLE_BASE_URL | No | The URL of the whistle Web UI. If not set, the server will auto-detect the running instance from ~/.startingAppData/, falling back to http://127.0.0.1:8899. | |
| WHISTLE_PASSWORD | No | The password for whistle authentication, if enabled. Optional. | |
| WHISTLE_USERNAME | No | The username for whistle authentication, if enabled. Optional. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| whistle_rule_listA | 获取 whistle 中所有规则列表 |
| whistle_rule_getB | 获取指定规则的详细内容 |
| whistle_rule_setB | 创建或更新规则。规则内容使用 whistle 规则语法，如：pattern resBody://{valueName} |
| whistle_rule_removeC | 删除指定规则 |
| whistle_rule_enableB | 启用指定规则 |
| whistle_rule_disableB | 禁用指定规则 |
| whistle_value_listA | 获取 whistle 中所有 Values（键值对）列表 |
| whistle_value_getB | 获取指定 Value 的内容 |
| whistle_value_setA | 创建或更新 Value。Value 用于存储 Mock 数据、模板等 |
| whistle_value_removeC | 删除指定 Value |
| whistle_mock_createA | 一键创建完整 Mock 方案：自动生成 Value（存储响应数据）+ 规则（匹配 URL），并立即启用 |
| whistle_mock_applyC | 启用或禁用指定的 Mock 规则 |
| whistle_sessions_listA | 获取最近抓包的 session 列表，可按 URL 或 HTTP 方法过滤 |
| whistle_session_getA | 获取单个请求的完整详情（请求头、请求体、响应头、响应体、耗时、规则等），自动解析 query 参数、POST 参数和响应 JSON 字段树 |
| whistle_sessions_searchA | 搜索抓包数据：按请求参数名（query/POST body）或响应 JSON 字段名过滤。例如：查找哪些请求带了 token 参数、哪些接口返回了 address 字段 |
| whistle_statusA | 检查 whistle 服务运行状态 |
| whistle_server_infoB | 获取 whistle 服务器信息（端口、版本、网络等） |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 17 tools
The tool set is organized by resource (rules, values, mocks, sessions, server), with clear distinctions between CRUD operations and enabling/disabling. The main ambiguity is whistle_mock_apply overlapping with whistle_rule_enable/disable, but the descriptions clarify the mock-specific scope. Overall, agents should be able to select the right tool.
Names follow a consistent whistle_<resource>_<action> pattern, with minor deviations: sessions_list (plural) vs session_get (singular), and the separate whistle_status and whistle_server_info break the pattern. These are small inconsistencies but the overall convention is clear and predictable.
With 17 tools, the server is slightly above the ideal range, but each tool serves a distinct need in managing Whistle's rules, values, mock setups, and session inspection. The count is justified by the breadth of functionality and does not feel excessive.
The rule and value tools provide full CRUD plus enable/disable, and session tools cover list/get/search. Mock creation automates the composition of values and rules, though there is no dedicated mock delete/update tool, requiring manual composition of rule/value operations. This is a minor gap that agents can work around.