Whistle MCP Server

English | 中文

プロジェクト紹介

Whistle MCP Serverは、Model Context Protocol (MCP) に基づいたWhistleプロキシ管理ツールであり、AIアシスタントがローカルのWhistleプロキシサーバーを直接操作・制御できるようにします。このツールを通じて、AIはユーザーがルール、グループ、値の管理、ネットワークリクエストの監視、リクエストのリプレイや変更などを行うのを支援でき、Whistleのインターフェースを手動で操作する必要がなくなります。これにより、ネットワークデバッグ、APIテスト、プロキシルール管理のプロセスが大幅に簡素化され、ユーザーはAIとの自然言語対話を通じて複雑なネットワークプロキシ設定タスクを完了できるようになります。

Related MCP server: MCP Server

機能

• ルール管理: Whistleルールの作成、更新、名前変更、削除、有効化/無効化

• グループ管理: グループの作成、名前変更、削除、およびルールとグループ間の関連付け操作

• 値管理: 値の作成、更新、名前変更、削除、および値グループ管理のサポート

• プロキシ制御: プロキシの有効化/無効化、HTTP/HTTPSインターセプト、HTTP/2プロトコルなどの制御

• リクエストインターセプト: インターセプトされたネットワークリクエスト情報の表示（URLフィルタリング対応）

• リクエストリプレイ: カスタムリクエストパラメータを使用したキャプチャ済みリクエストのリプレイサポート

• マルチルールモード: マルチルールモードの有効化/無効化サポート

インストール

要件

Node.js 18.20.0以降が必要です (package.jsonのenginesを参照)。古いバージョンはサポートされていません。

Smithery経由でのインストール

Smithery を介してClaude Desktop用のWhistle MCP Serverを自動的にインストールするには：

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

手動インストール

npmを使用してWhistle MCP Serverをグローバルにインストールできます：

npm install -g whistle-mcp-tool

ソースからのビルド

リポジトリのルートから：

npm install
npm run build

ビルド出力のエントリは dist/index.js です（グローバルインストール後の whistle-mcp CLIで使用されるファイルと同じです）。node と dist/index.js へのパスを使用してMCP設定で指定することもできます。

MCP設定

トランスポート (stdio vs HTTP)

デフォルトでは、サーバーは stdio を使用します（CursorなどのローカルMCPクライアントに適しています）。

同じプロセスで Streamable HTTP と SSE を公開する場合（リモートまたはHTTP対応クライアント用）、--transport http-stream を使用します。FastMCPは --mcp-host / --mcp-port でリッスンし、以下を提供します：

• Streamable HTTP: http://<mcp-host>:<mcp-port><mcp-endpoint> (デフォルトパス /mcp)

• SSE: http://<mcp-host>:<mcp-port>/sse

http-stream のエイリアス: sse, streamable-http (同じモード。両方のURLが利用可能です)。

Whistle 接続オプションは変更されません: --host, --port, --username / --password (または -n / -w)。

例 (HTTPトランスポート + 8899でローカルWhistleを実行; MCPはデフォルトで 8085 をリッスン)：

whistle-mcp --transport http-stream --host 127.0.0.1 --port 8899

デフォルトの 8085 を上書きするには --mcp-port <port> を使用してください。

インストール後、MCP JSON設定ファイルでWhistle MCPを設定できます：

{
  "mcpServers": {
    "whistle-mcp": {
      "command": "whistle-mcp",
      "args": [
        "--host=<whistle server IP address>",
        "--port=<whistle server port number>"
      ]
    }
  }
}

Whistleを基本認証で開始した場合（Whistle CLIと同じフラグ: w2 start -n <username> -w <password>）、WhistleのAPIへのHTTPリクエストが成功するように、このMCPサーバーにも 同じ 資格情報を渡してください：

{
  "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

設定の詳細

• host: WhistleサーバーのIPアドレス。省略した場合は localhost がデフォルトになります

• port: Whistleサーバーのポート。省略した場合は 8899 がデフォルトになります

• username (-n / --username): Whistleが -n で開始された場合の基本認証ユーザー名。Whistleにログインがない場合は省略してください

• password (-w / --password): Whistleが -w で開始された場合の基本認証パスワード。ユーザー名が設定されていてパスワードが省略された場合、空のパスワードが送信されます

AIクライアントでのMCP JSONの設定

• Claude Client: https://modelcontextprotocol.io/quickstart/user

• Raycast: MCPプラグインのインストールが必要

• Cursor: https://docs.cursor.com/context/model-context-protocol#configuring-mcp-servers

MCPツール説明

Whistle MCP Serverは、MCPプロトコルを介して呼び出せる以下のツールを提供します：

ルール管理

グループ管理

値管理

プロキシ制御

リクエスト管理

ユーティリティ

連絡先情報

• Email: gz7gugu@qq.com

• Blog: https://7gugu.com