Mullvad VPN MCP Server

mullvad-mcp

一个 MCP（Model Context Protocol）服务，可通过任何兼容 MCP 的客户端控制 Mullvad VPN——包括 Claude Desktop、Cursor、Windsurf 等。

所有 VPN 操作均通过 mullvad CLI 完成。不直接调用 API，不解析配置文件，也不需要凭据。

前置条件

• 已安装 Mullvad VPN 应用，且 CLI 位于 PATH 中
  • 验证：mullvad --version
  • 下载 Mullvad
• Python 3.11+
• uv 包管理器——安装 uv

安装

git clone https://github.com/your-username/mullvad-mcp.git
cd mullvad-mcp
uv sync

客户端配置

Claude Desktop

添加到 ~/.config/claude-desktop/claude_desktop_config.json（Linux）或 ~/Library/Application Support/Claude/claude_desktop_config.json（macOS）：

{
  "mcpServers": {
    "mullvad": {
      "command": "uv",
      "args": ["--directory", "/path/to/mullvad-mcp", "run", "mullvad-mcp"]
    }
  }
}

Cursor

添加到项目中的 .cursor/mcp.json，或全局配置文件 ~/.cursor/mcp.json：

{
  "mcpServers": {
    "mullvad": {
      "command": "uv",
      "args": ["--directory", "/path/to/mullvad-mcp", "run", "mullvad-mcp"]
    }
  }
}

通用 MCP 客户端（stdio）

{
  "mcpServers": {
    "mullvad": {
      "command": "uv",
      "args": ["--directory", "/path/to/mullvad-mcp", "run", "mullvad-mcp"],
      "transport": "stdio"
    }
  }
}

可用工具

连接控制

工具	描述
connect	连接 VPN，可指定国家／城市／主机名
disconnect	断开 VPN 连接
reconnect	重新连接，可选择新位置

状态与诊断

工具	描述
get_status	当前连接状态、服务、协议和 IP
check_leak	查询 am.i.mullvad.net，验证 VPN 保护是否生效

服务选择

工具	描述
list_countries	所有可用国家及服务数量
list_cities	指定国家的城市
list_servers	按条件筛选服务（国家、城市、owned_only）
set_location	按国家、城市或主机名设置首选位置

账户管理

工具	描述
get_account_info	屏蔽后的账号号码、到期日期
get_device_info	已注册到该账号的设备

设置

工具	描述
get_settings	以结构化对象形式返回所有当前设置
set_killswitch	启用／停用锁定模式
set_daita	启用／停用 DAITA（流量分析防护）
set_multihop	启用／停用多跳，可选择入口位置
set_dns	设置 DNS：默认模式（含拦截选项）或自定义 IP
set_protocol	配置 WireGuard 选项（抗量子、IPv6）
set_obfuscation	设置反审查模式（auto/off/udp2tcp/shadowsocks 等）

交互示例

连接

“帮我连接到瑞典”

→ 调用 connect(country="se")——将中继设为瑞典并连接。

状态检查

“我的流量有泄漏吗？”

→ 调用 check_leak()——查询 am.i.mullvad.net，并报告流量是否通过 Mullvad 出口。

服务选择

“德国有哪些可用城市？”

→ 调用 list_cities(country="de")——返回柏林、法兰克福等城市及服务数量。

设置

“启用终止开关并拦截广告”

→ 先调用 set_killswitch(enabled=True)，再调用 set_dns(block_ads=True)。

环境变量

变量	默认值	描述
MULLVAD_CLI_PATH	自动检测	覆盖 mullvad 二进制文件的路径
MULLVAD_CLI_TIMEOUT	10	CLI 命令超时时间，单位为秒

工作原理

所有工具都通过子进程调用 mullvad CLI。CLI 会原生处理身份验证——无需 API 密钥或密钥。输出会被解析为结构化字典，供大模型分析结果。

资源

• Mullvad CLI 文档
• Model Context Protocol
• MCP Python SDK

许可证

MIT