whistle.agent-mcp
whistle.agent-mcp
Lassen Sie KI-Assistenten mit MCP-Unterstützung direkt den aktuell von Whistle erfassten HTTP-, HTTPS- und WebSocket-Datenverkehr abfragen.
Sie müssen keine Sitzungen exportieren, Antwortinhalte kopieren oder Anfrageinformationen manuell aufbereiten. Nach der Verbindung können Sie die KI direkt bitten, Anfragen zu durchsuchen, vollständige Sitzungen anzusehen und WebSocket-Frames zu analysieren.
Wofür es geeignet ist
Anfragen finden, die kürzlich fehlgeschlagen sind, ein Timeout hatten oder eine bestimmte URL getroffen haben.
Anfrageheader, Antwortheader, Textkörper, Dauer und zugehörige Match-Regeln einer einzelnen Anfrage anzeigen.
WebSocket-Nachrichteninhalte und Sende-/Empfangsrichtung untersuchen.
Netzwerkprobleme mit KI-Unterstützung analysieren, ohne die Whistle-Konfiguration oder die erfassten Daten zu verändern.
Related MCP server: Reqable MCP Server
Schnellstart
Voraussetzungen: Node.js 20+, Whistle>=2.10.7.
Kopieren Sie bei der ersten Verwendung alle folgenden Befehle und führen Sie sie aus:
npm install -g whistle@latest
w2 install @wilson_janet/whistle.agent-mcp
w2 startWenn Whistle bereits läuft, installieren Sie einfach das Plugin und starten Sie es neu:
w2 install @wilson_janet/whistle.agent-mcp
w2 restartBestätigen Sie, dass das Plugin verfügbar ist:
curl http://127.0.0.1:8899/whistle.agent-mcp/healthFügen Sie in der Konfigurationsdatei des MCP-Clients Folgendes hinzu:
{
"mcpServers": {
"whistle": {
"url": "http://127.0.0.1:8899/whistle.agent-mcp/mcp"
}
}
}Nach der Verbindung können Sie direkt so fragen:
查找最近 20 个状态码为 500 的请求。
查看 URL 包含 /api/orders 的最新请求,分析它为什么失败。
读取会话 1750000000000-001 的请求、响应和耗时。
查看指定 WebSocket 会话最近由服务端发送的消息。Verfügbare Werkzeuge
Werkzeug | Zweck |
| Sucht in erfassten Sitzungen nach URL, Methode, Statuscode, Typ oder Zeit. |
| Liest Anfrage, Antwort, Dauer und zugehörige Match-Regeln einer einzelnen Sitzung. |
| Liest Frames von WebSocket- oder Socket-Sitzungen. |
Die Sitzungs-IDs aus den Suchergebnissen können an die Detail- und Frame-Abfragewerkzeuge weitergegeben werden.
Sicherheit und Einschränkungen
Alle Werkzeuge sind schreibgeschützt; sie ändern weder Regeln, Proxyeinstellungen noch erfasste Daten und spielen keine Anfragen erneut ab.
Sensible Anfrageheader wie
authorization,cookie, API-Schlüssel, Token usw. werden automatisch durch[REDACTED]ersetzt.Textinhalte werden auf 200.000 Zeichen begrenzt; binäre Inhalte geben nur eine base64-Vorschau mit begrenzter Länge zurück.
Die Daten stammen aus dem In-Memory-Cache von Whistle; ältere Sitzungen können bereits abgelaufen sein.
Standardmäßig wird nur der lokale Origin akzeptiert. Setzen Sie den Whistle-UI-Port ohne Authentifizierung keinen nicht vertrauenswürdigen Netzwerken aus.
Um einen Bearer-Token für den MCP-Endpunkt hinzuzufügen, setzen Sie ihn beim Start von Whistle:
WHISTLE_MCP_TOKEN='your-token' w2 restartKonfigurieren Sie dann im MCP-Client denselben Bearer-Token für diesen Dienst. Über WHISTLE_MCP_ALLOWED_ORIGINS können zusätzliche exakte Origins hinzugefügt werden; mehrere Werte werden durch Kommas getrennt.
Entwicklung
Wechseln Sie in das Projektverzeichnis, installieren Sie die Abhängigkeiten und bauen Sie das Projekt:
npm install
npm run buildBeim Laden des lokalen Plugins aus dem Quellcode muss -A auf das übergeordnete Verzeichnis zeigen, das whistle.agent-mcp enthält:
w2 start -A ..Starten Sie den TypeScript-Watcher, Whistle und das Neuladen des lokalen Plugins:
npm run devVollständige Verifizierung:
npm run check
npm test
npm run build
npm run smokenpm run smoke:api stellt zusätzlich eine Verbindung zur lokal installierten Whistle Local Agent API her und überprüft die Abfragefunktionen anhand der aktuell erfassten Daten.
Projektstruktur
index.cjs Whistle 插件入口
src/
plugin/handler.ts HTTP 路由与访问控制
mcp/server.ts MCP 工具定义
whistle/ API 适配、查询、脱敏、错误与类型
testing/smoke.ts 构建后的端到端 smoke test
test/
whistle/ Whistle 相关单元测试
scripts/dev.sh 本地开发脚本Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only
Search and inspect source-pinned agent skills, plugins and tools through a free public MCP.
Live browser debugging for AI assistants — DOM, console, network via MCP.
A paid remote MCP for AI agent browser DevTools MCP, built to return verdicts, receipts, usage logs,
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 a3224 npm45MIT
- AlicenseBqualityDmaintenanceExposes local Reqable network capture traffic to MCP clients for real-time monitoring and analysis of HTTP requests. It enables developers to query, search, and generate code from captured traffic stored locally within a private SQLite database.1733 PyPI238MIT
- AlicenseCqualityBmaintenanceTransforms mitmproxy into a toolset for AI agents to inspect, modify, and replay HTTP/HTTPS traffic in real-time.25255 PyPI136MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI to analyze real-time HTTP(S) traffic captured by ProxyPin, with tools to browse, search, and inspect requests and responses, as well as access saved history sessions.11 npm4MIT