Skip to main content
Glama
Sign In
mihomo-mcp

mihomo-mcp

by wlor0623
OverviewSchemaSourceRelated ServersDiscussionsAdmin
JavaScript
Local

mihomo-mcp

让 AI(MCP 客户端)直接管理你电脑上的 mihomo / Clash Meta 内核 —— 切节点、测延迟、看连接、切运行模式、开关 TUN 和 Windows 系统代理。

与 Clash Verge Rev 零配置兼容:Verge 2.x 的 GUI 本身就是通过 Windows 命名管道控制 mihomo 内核的,本工具走同一条管道,不需要在 Verge 里开任何设置,不改源码,不暴露端口。

ZCode / Claude / Cline ──stdio──> mihomo-mcp ──HTTP over 命名管道──> mihomo 内核
                                                                       ↑
                                        Clash Verge GUI(同一通道,互不干扰)

接入

任何支持 MCP 的客户端(ZCode / Claude Desktop / Cline / Cherry Studio 等),在 mcpServers 配置里加:

{
  "mcpServers": {
    "mihomo-mcp": {
      "command": "node",
      "args": ["<本项目路径>/src/index.mjs"]
    }
  }
}

全局安装后也可以直接用命令名:

npm i -g mihomo-mcp
# 然后 command: "mihomo-mcp"

Related MCP server: MCP Cloud Gateway

环境变量(全部可选)

变量

默认值

说明

MIHOMO_PIPE

\\.\pipe\verge-mihomo

mihomo 命名管道。Verge Rev 2.x 用这个默认值;其他发行版(裸 mihomo、Nyanpasu)改管道名即可

MIHOMO_HTTP

空

设置后改走 HTTP 外部控制,如 http://127.0.0.1:9097(需在客户端里开启「外部控制」)

MIHOMO_SECRET

空

HTTP 外部控制的 secret,管道模式通常不需要

工具列表

工具

说明

get_version

内核版本 + 当前通道

list_proxies

所有代理组:类型、当前节点、候选节点列表

switch_proxy

切换某组的选中节点

delay_test

测单节点或整组延迟(整组返回最快前 5)

get_connections

当前连接明细(按流量排序),支持关闭指定连接

get_configs

运行模式 / TUN / 混合端口 / 允许局域网

set_mode

切 rule / global / direct

set_tun

开关 TUN 虚拟网卡

toggle_system_proxy

开关 Windows 系统代理(写注册表 + WinINET 通知)

get_rules

查看分流规则,支持关键词过滤

说明与坑

  • 系统代理开关是应用层功能:mihomo 内核 API 管不到 Windows 代理设置,所以 toggle_system_proxy 是直接改注册表 HKCU\...\Internet Settings 并通过 InternetSetOption 通知应用。副作用:Clash Verge 界面上的开关状态不会实时同步,属正常现象,以注册表为准。

  • Verge 里默认不用开「外部控制」:那是 HTTP 通道的开关;管道通道只要 Verge 在运行就存在。

  • set_tun 可能被 GUI 覆盖:Verge 重载订阅/改设置时会按它界面里的状态重写 TUN 配置,以 Verge 界面为长期开关,本工具适合临时切换。

  • 多订阅/切换 profile(Verge 应用层功能)暂不支持,后续版本计划通过读 Verge 的 profiles.yaml + PUT /configs?force=true 实现。

兼容性

实测 Clash Verge Rev 2.4.5(mihomo v1.19.x,Windows 11)。理论上任何暴露 mihomo RESTful API 的场景都可用:裸 mihomo(设 external-controller-pipe 或用 MIHOMO_HTTP)、Clash Nyanpasu 等。

License

MIT

Available Tools

10 tools
delay_testA

测延迟:传 name 测单个节点,传 group 测整组并给出最快的几个

Inputs: url, name, group, timeout.

get_configsA

查看内核运行配置:运行模式、TUN、混合端口、局域网共享等

Inputs: no named parameters.

get_connectionsB

查看当前全部连接的流量统计与明细(按下载量排序),可传 closeId 关闭指定连接

Inputs: limit, closeId.

get_rulesC

查看内核规则表,支持关键词过滤

Inputs: limit, search.

get_versionB

查看 mihomo 内核版本和当前连接通道(命名管道/HTTP)

Inputs: no named parameters.

list_proxiesA

列出所有代理组(含每组当前选中节点和全部候选节点名)与节点延迟概览

Inputs: no named parameters.

set_modeB

切换内核运行模式: rule=规则分流 / global=全局代理 / direct=全部直连

Inputs: mode (required).

set_tunB

开关 TUN 虚拟网卡模式。注意:Verge 重载订阅后可能恢复其界面里的设置

Inputs: enable (required).

switch_proxyB

切换某个代理组的当前选中节点

Inputs: name (required), group (required).

toggle_system_proxyA

开关 Windows 系统代理(改注册表并通知应用生效)。enable 不传则翻转当前状态

Inputs: port, enable.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Deploy Server
    One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

    TDQS

    A3.5/5.0

    Scored across 10 tools

    Disambiguation4/5

    Most tools target a distinct resource and action (e.g., get_connections vs get_rules vs get_configs), but delay_test and list_proxies both surface latency information, and the three toggle/set tools (set_mode, set_tun, toggle_system_proxy) touch related proxy settings. Descriptions help differentiate them, so confusion is minor.

    Naming Consistency4/5

    Predominantly consistent verb_noun snake_case pattern (get_connections, set_mode, list_proxies, switch_proxy). The only deviation is delay_test, which follows noun_verb order instead of test_delay or get_delay.

    Tool Count5/5

    10 tools is a well-scoped set for a mihomo core controller, covering status, configuration, proxy management, and connection details without redundancy. Each tool earns its place.

    Completeness4/5

    Core operational workflows are covered: viewing configs, mode/TUN/system proxy toggles, proxy listing/switching, latency testing, rules, connections, and version. Minor gaps exist, such as setters for other config fields revealed by get_configs (e.g., mixed port, LAN sharing) and no subscription reload or rule editing.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Resources

    Related MCP Connectors

    Related MCP Servers

    • mcp-opentym

      doanhtuan123
      F
      license
      Not graded
      quality
      D
      maintenance
      A lightweight MCP HTTP server giving AI assistants real tools to interact with your Windows machine, including running commands, file access, system info, web search, and browser automation.
      1
      -

    • MCP Cloud Gateway

      unlimitedusers
      A
      license
      Not graded
      quality
      C
      maintenance
      Unifies local MCP servers into a single secure Cloudflare Tunnel endpoint, making them accessible to MCP clients like Notion and Claude. Supports HTTP/SSE/stdio servers, built-in file system tools, bearer authentication, and one-click Windows setup.
      MIT

    • MiMo Desktop MCP

      akaradje
      A
      license
      Not graded
      quality
      B
      maintenance
      A local MCP server that lets an assistant observe and control Windows application windows, plus interact with Xiaomi MiMo AI Desktop workflows, through 22 tools for Unicode typing, smooth dragging, cross-window drops, and bounded SSE streaming.
      MIT