whistle.agent-mcp

English

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: Android Proxy MCP

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 start

Wenn Whistle bereits läuft, installieren Sie einfach das Plugin und starten Sie es neu:

w2 install @wilson_janet/whistle.agent-mcp
w2 restart

Bestätigen Sie, dass das Plugin verfügbar ist:

curl http://127.0.0.1:8899/whistle.agent-mcp/health

Fü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

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 restart

Konfigurieren 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 build

Beim 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 dev

Vollständige Verifizierung:

npm run check
npm test
npm run build
npm run smoke

npm 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         本地开发脚本