Return mihomo-mcp package version and connected mihomo version.

List all proxy groups with their current selection and node count.

Returns a list of groups, each with: name, type, current (the active proxy), and the number of available nodes. Selector/URLTest groups show all options; Direct/Reject/Compatible show a single fixed value.

Switch a Selector/URLTest group to a specific proxy.

Args: group: the group name (e.g. "GLOBAL", "Manual") proxy: the proxy name to select (e.g. "🇭🇰香港01 [1×] - Lv.4")

Returns the new selection. Mihomo returns 400 if the proxy is not in the group's all-list (case-sensitive).

Test latency (ms) for a single proxy.

Args: proxy: proxy name (must match an entry in a group's all-list) url: target URL, default is gstatic.com/generate_204 (used by mihomo itself) timeout_ms: per-test timeout in milliseconds (default 5000)

Returns the delay in ms, or {"delay": -1} if the test failed.

Test latency of every proxy in a group, sorted by delay (fastest first).

Args: group: the selector group to test url: target URL timeout_ms: per-proxy timeout concurrency: max parallel probes (default 8)

Returns a list of {name, delay_ms, ok} sorted by delay. Failed probes show delay=-1 and are placed at the end.

List all proxy providers with node counts and last update info.

Returns: list of {name, type, vehicle_type, node_count, updated_at}.

Trigger health check on a provider (force-refresh + delay measurement).

Args: provider: provider name (e.g. "MyVPN")

Returns a no-content confirmation (mihomo returns 204). The actual health state is observable via provider_list.

Update a provider's subscription URL and trigger a refresh.

Args: provider: provider name url: new subscription URL (forwarded to mihomo, never persisted)

The URL is sent to mihomo via PUT and used immediately. It is not cached, logged, or written to disk by this server.

Switch operating mode: rule (default), global, or direct.

Args: mode: one of "rule", "global", "direct"

• rule: use rules to decide what goes through proxy

• global: all traffic through proxy

• direct: all traffic bypasses proxy

List active connections (source ip, host, rule, chains, upload, download).

Returns a list of connection objects. An empty list means no active connections (mihomo returns {connections: null} on idle).