World Monitor
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Administer wg-easy (WireGuard Easy) v15: manage VPN clients, configs, QR codes and server status
列表按使用分(满分 100)排序,由以下部分组成
| 热度 | 0/80 | GitHub 星标或每周下载量:较大的计 60,较小的计 20 |
|---|---|---|
| 新鲜度 | 12/12 | 30 天内有发布或代码更新得满分 |
| 仍在响应 | 0/8 | 上次检查时云端端点有响应 |
| 使用分 | 12/100 |
质量: 基础检查通过 3/3 项(仅展示,不用于排序) · 上升势头: 暂无数据 (只用于“上升中”标签)
选择你使用的 AI 应用,然后复制设置。
用一句话让 AI 帮你安装
请帮我安装 wg-easy。按照 https://mcp.popnx.com/i/ni-c-wg-easy-mcp.md 操作,先把命令给我看,等我同意后再运行。粘贴到能在你电脑上工作的 AI(如 Claude Code、Cursor)。它会读取我们的步骤,先给你看命令,等你同意。无需密钥,无需注册。 · 查看 AI 会读取的全文
通过 3/3 项检查 · 在你的电脑上运行 · ✓ 命令已检查 2026年11月14日
第一步:你用哪个 AI?
选择你用的应用,步骤会显示在下方。
可连接 Claude,但需要先准备
需要 wg-easy 的密钥(在开发者网站创建) · 需要填写 2 项设置(WG_EASY_URL, WG_EASY_USERNAME) · 需要先在电脑上安装 Node.js(只需一次) · 仅限电脑上的 Claude 应用(Windows 或 Mac),网页和手机不可用
把这段话复制到 Claude 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。
请在这台电脑上为 Claude 安装 MCP server wg-easy,按顺序:1) 用 node -v 检查是否有 Node.js。没有的话,请让我从 https://nodejs.org/en/download 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "mcpServers": { "wg-easy": { "command": "npx", "args": [ "-y", "wg-easy-mcp" ], "env": { "WG_EASY_URL": "your-value", "WG_EASY_USERNAME": "your-value", "WG_EASY_PASSWORD": "your-value" } } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) WG_EASY_PASSWORD, WG_EASY_URL, WG_EASY_USERNAME 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 wg-easy 的工具真的出现了。这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
node -vMac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: 打开官方下载页,选择 LTS 版本和点选式安装程序:Mac 用 .pkg · Windows 用 .msi。双击后一路下一步即可,不需要 curl 命令
装好后关掉终端再打开,重新运行同一条命令,应显示版本号: node -v
安装一次,所有需要 Node.js 的工具都能用
这些是程序设置,不是密钥,无需注册。按开发者的说明填写。
WG_EASY_URL Base URL of the wg-easy web UI, e.g. https://vpn.example.com:51821WG_EASY_USERNAME wg-easy 管理员账户的用户名(必须禁用两步验证) 说明为自动翻译,变量名保持原样;不确定时请查看原文。
SettingsDeveloperEdit Config
{
"mcpServers": {
"wg-easy": {
"command": "npx",
"args": [
"-y",
"wg-easy-mcp"
],
"env": {
"WG_EASY_URL": "your-value",
"WG_EASY_USERNAME": "your-value",
"WG_EASY_PASSWORD": "your-value"
}
}
}
}只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
用 wg-easy 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude 说正在使用 wg-easy,或回答中出现 wg-easy 的工具名称,就表示连接成功
上面的命令不填这些也能用。想调整时再按开发者的说明添加。
WG_EASY_INSECURE_TLS 设置为 true 以接受自签名 TLS 证书(仅限于 wg-easy 连接)。 WG_EASY_READ_ONLY 设为 true 则只注册读取类工具(默认:false) WG_EASY_ALLOW_TOOLS 以逗号分隔的工具名称或 list_ 前缀,用于注册;'essential' 选择精选预设(默认:所有工具) WG_EASY_DENY_TOOLS Comma-separated tool names or list_* prefixes to remove from whatever WG_EASY_ALLOW_TOOLS left说明为自动翻译,变量名保持原样;不确定时请查看原文。
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
ChatGPT 暂时无法连接 wg-easy
wg-easy 需要安装在你的电脑上,而 ChatGPT 只能连接在网上运行的服务器
A · 使用能连接 wg-easy 的应用
B · 其他 类中能连接 ChatGPT 的其他服务器
从同类中使用较多的里挑选,仅限用地址即可连接、无需密钥的
可连接 Claude Code,但需要先准备
需要 wg-easy 的密钥(在开发者网站创建) · 需要填写 2 项设置(WG_EASY_URL, WG_EASY_USERNAME) · 需要先在电脑上安装 Node.js(只需一次)
把这段话复制到 Claude Code 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。
请在这台电脑上为 Claude Code 安装 MCP server wg-easy,按顺序:1) 用 node -v 检查是否有 Node.js。没有的话,请让我从 https://nodejs.org/en/download 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):claude mcp add --scope user wg-easy --env WG_EASY_URL=your-value --env WG_EASY_USERNAME=your-value --env WG_EASY_PASSWORD=your-value -- npx -y wg-easy-mcp 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) WG_EASY_PASSWORD, WG_EASY_URL, WG_EASY_USERNAME 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 wg-easy 的工具真的出现了。这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
node -vMac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: 打开官方下载页,选择 LTS 版本和点选式安装程序:Mac 用 .pkg · Windows 用 .msi。双击后一路下一步即可,不需要 curl 命令
装好后关掉终端再打开,重新运行同一条命令,应显示版本号: node -v
安装一次,所有需要 Node.js 的工具都能用
这些是程序设置,不是密钥,无需注册。按开发者的说明填写。
WG_EASY_URL Base URL of the wg-easy web UI, e.g. https://vpn.example.com:51821WG_EASY_USERNAME wg-easy 管理员账户的用户名(必须禁用两步验证) 说明为自动翻译,变量名保持原样;不确定时请查看原文。
Mac:按 Command+空格,输入 Terminal · Windows:打开 PowerShell
claude mcp add --scope user wg-easy --env WG_EASY_URL=your-value --env WG_EASY_USERNAME=your-value --env WG_EASY_PASSWORD=your-value -- npx -y wg-easy-mcp按 Enter 前,把“your-value”改成你的密钥
只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
应能看到 wg-easy 在列表中并显示已连接
用 wg-easy 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Claude Code 说正在使用 wg-easy,或回答中出现 wg-easy 的工具名称,就表示连接成功
上面的命令不填这些也能用。想调整时再按开发者的说明添加。
WG_EASY_INSECURE_TLS 设置为 true 以接受自签名 TLS 证书(仅限于 wg-easy 连接)。 WG_EASY_READ_ONLY 设为 true 则只注册读取类工具(默认:false) WG_EASY_ALLOW_TOOLS 以逗号分隔的工具名称或 list_ 前缀,用于注册;'essential' 选择精选预设(默认:所有工具) WG_EASY_DENY_TOOLS Comma-separated tool names or list_* prefixes to remove from whatever WG_EASY_ALLOW_TOOLS left说明为自动翻译,变量名保持原样;不确定时请查看原文。
菜单名称已于 2026年11月11日 对照 Anthropic 帮助页面核实 · 你的界面可能因版本略有不同
可连接 Cursor,但需要先准备
需要 wg-easy 的密钥(在开发者网站创建) · 需要填写 2 项设置(WG_EASY_URL, WG_EASY_USERNAME) · 需要先在电脑上安装 Node.js(只需一次)
把这段话复制到 Cursor 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。
请在这台电脑上为 Cursor 安装 MCP server wg-easy,按顺序:1) 用 node -v 检查是否有 Node.js。没有的话,请让我从 https://nodejs.org/en/download 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "mcpServers": { "wg-easy": { "command": "npx", "args": [ "-y", "wg-easy-mcp" ], "env": { "WG_EASY_URL": "your-value", "WG_EASY_USERNAME": "your-value", "WG_EASY_PASSWORD": "your-value" } } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) WG_EASY_PASSWORD, WG_EASY_URL, WG_EASY_USERNAME 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 wg-easy 的工具真的出现了。这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
node -vMac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: 打开官方下载页,选择 LTS 版本和点选式安装程序:Mac 用 .pkg · Windows 用 .msi。双击后一路下一步即可,不需要 curl 命令
装好后关掉终端再打开,重新运行同一条命令,应显示版本号: node -v
安装一次,所有需要 Node.js 的工具都能用
这些是程序设置,不是密钥,无需注册。按开发者的说明填写。
WG_EASY_URL Base URL of the wg-easy web UI, e.g. https://vpn.example.com:51821WG_EASY_USERNAME wg-easy 管理员账户的用户名(必须禁用两步验证) 说明为自动翻译,变量名保持原样;不确定时请查看原文。
在 wg-easy 的设置中,WG_EASY_PASSWORD, WG_EASY_URL, WG_EASY_USERNAME 还是空的,填入你的密钥并保存
只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
用 wg-easy 告诉我你能帮我做什么,然后做一件给我看✓ 如果 Cursor 说正在使用 wg-easy,或回答中出现 wg-easy 的工具名称,就表示连接成功
上面的命令不填这些也能用。想调整时再按开发者的说明添加。
WG_EASY_INSECURE_TLS 设置为 true 以接受自签名 TLS 证书(仅限于 wg-easy 连接)。 WG_EASY_READ_ONLY 设为 true 则只注册读取类工具(默认:false) WG_EASY_ALLOW_TOOLS 以逗号分隔的工具名称或 list_ 前缀,用于注册;'essential' 选择精选预设(默认:所有工具) WG_EASY_DENY_TOOLS Comma-separated tool names or list_* prefixes to remove from whatever WG_EASY_ALLOW_TOOLS left说明为自动翻译,变量名保持原样;不确定时请查看原文。
菜单名称已于 2026年11月11日 对照 Cursor 帮助页面核实 · 你的界面可能因版本略有不同
可连接 VS Code,但需要先准备
需要 wg-easy 的密钥(在开发者网站创建) · 需要填写 2 项设置(WG_EASY_URL, WG_EASY_USERNAME) · 需要先在电脑上安装 Node.js(只需一次)
把这段话复制到 VS Code 的对话里。AI 会先检查电脑,告诉你要改哪个文件,并且每次都等你同意。
请在这台电脑上为 VS Code 安装 MCP server wg-easy,按顺序:1) 用 node -v 检查是否有 Node.js。没有的话,请让我从 https://nodejs.org/en/download 安装,不要自己安装。2) 只使用这份配置(已通过 PopNx MCP 检查):{ "servers": { "wg-easy": { "type": "stdio", "command": "npx", "args": [ "-y", "wg-easy-mcp" ], "env": { "WG_EASY_URL": "your-value", "WG_EASY_USERNAME": "your-value", "WG_EASY_PASSWORD": "your-value" } } } } 3) 告诉我要修改的文件完整路径或要运行的命令,等我同意。4) WG_EASY_PASSWORD, WG_EASY_URL, WG_EASY_USERNAME 先保留 "your-value",请我自己把真实值粘贴到文件或应用的输入框里。不要让我在对话里输入密钥。5) 按约定执行,然后确认 wg-easy 的工具真的出现了。这段话不包含你的密钥。如果需要密钥,AI 会请你自己粘贴到文件或应用的输入框里。
已经装好了吗?先检查 · 打开终端,输入这条命令后按 Enter
node -vMac:按 ⌘ + Space,输入 Terminal 后按 Enter
Windows:打开“开始”菜单,输入 Windows PowerShell,然后选“打开”
还没安装: 打开官方下载页,选择 LTS 版本和点选式安装程序:Mac 用 .pkg · Windows 用 .msi。双击后一路下一步即可,不需要 curl 命令
装好后关掉终端再打开,重新运行同一条命令,应显示版本号: node -v
安装一次,所有需要 Node.js 的工具都能用
这些是程序设置,不是密钥,无需注册。按开发者的说明填写。
WG_EASY_URL Base URL of the wg-easy web UI, e.g. https://vpn.example.com:51821WG_EASY_USERNAME wg-easy 管理员账户的用户名(必须禁用两步验证) 说明为自动翻译,变量名保持原样;不确定时请查看原文。
在 wg-easy 的设置中,WG_EASY_PASSWORD, WG_EASY_URL, WG_EASY_USERNAME 还是空的,填入你的密钥并保存
只把密钥粘贴到应用的输入框里,不要粘贴到聊天中或发给任何人
用 wg-easy 告诉我你能帮我做什么,然后做一件给我看✓ 如果 VS Code 说正在使用 wg-easy,或回答中出现 wg-easy 的工具名称,就表示连接成功
上面的命令不填这些也能用。想调整时再按开发者的说明添加。
WG_EASY_INSECURE_TLS 设置为 true 以接受自签名 TLS 证书(仅限于 wg-easy 连接)。 WG_EASY_READ_ONLY 设为 true 则只注册读取类工具(默认:false) WG_EASY_ALLOW_TOOLS 以逗号分隔的工具名称或 list_ 前缀,用于注册;'essential' 选择精选预设(默认:所有工具) WG_EASY_DENY_TOOLS Comma-separated tool names or list_* prefixes to remove from whatever WG_EASY_ALLOW_TOOLS left说明为自动翻译,变量名保持原样;不确定时请查看原文。
菜单名称已于 2026年11月11日 对照 VS Code 帮助页面核实 · 你的界面可能因版本略有不同
Claude Code
claude mcp add --scope user wg-easy --env WG_EASY_URL=your-value --env WG_EASY_USERNAME=your-value --env WG_EASY_PASSWORD=your-value -- npx -y wg-easy-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"wg-easy": {
"command": "npx",
"args": [
"-y",
"wg-easy-mcp"
],
"env": {
"WG_EASY_URL": "your-value",
"WG_EASY_USERNAME": "your-value",
"WG_EASY_PASSWORD": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"wg-easy": {
"command": "npx",
"args": [
"-y",
"wg-easy-mcp"
],
"env": {
"WG_EASY_URL": "your-value",
"WG_EASY_USERNAME": "your-value",
"WG_EASY_PASSWORD": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"wg-easy": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"wg-easy-mcp"
],
"env": {
"WG_EASY_URL": "your-value",
"WG_EASY_USERNAME": "your-value",
"WG_EASY_PASSWORD": "your-value"
}
}
}
}WG_EASY_URL 必填 envWG_EASY_USERNAME 必填 envWG_EASY_PASSWORD 机密 必填 envWG_EASY_INSECURE_TLS envWG_EASY_READ_ONLY envWG_EASY_ALLOW_TOOLS envWG_EASY_DENY_TOOLS env说明为自动翻译,变量名保持原样;不确定时请查看原文。
这些设置是根据作者在注册中心的条目生成的。如果 README 的写法不同,请以 README 为准。
依据这个服务器的连接方式和各应用自己的文档,检查于 2026年11月10日。
在你的电脑上运行,适用于
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
它在你的电脑上运行;安装后,工具列表会显示在你的 AI 应用中。
我们检查的是任何人都能看到的信息;我们没有阅读代码。不适用的检查项不计入总数。 · 检查于 2026年11月19日
注册名称已通过 GitHub 账户 ni-c 验证,该账户拥有此仓库
代码最后更新于前天
使用 MIT
它在你的电脑上运行,没有互联网端点
在你的电脑上运行,改用本地设置
它在你的电脑上运行;我们只能读取互联网端点的工具列表
OSV.dev 中没有 wg-easy-mcp@0.6.0 的记录
只检查这个版本的包本身,不包括所有依赖 · 检查于 2026年11月16日
如果你是作者,可把这段代码贴到 README。徽章会链接回本页。
[](https://mcp.popnx.com/en/servers/ni-c-wg-easy-mcp)提问、分享技巧或报告无法使用。按“有帮助”数量排序。
还没有评价
与注册中心里这个分类中所有活跃的服务器比较。只有当发布者拥有该仓库时,星标数才计入。
它在 3 项适用的基础检查中通过了 3 项。我们没有阅读代码。在添加密钥或令牌之前,请先看看这个服务器要求哪些权限,并使用只具备所需权限的密钥。
你需要填写:WG_EASY_PASSWORD
它在你的电脑上运行。你的 AI 应用会在需要时启动它,数据不会经过作者的服务器(除非它自己调用在线服务)。
GitHub 仓库最后更新于前天,最新版本(0.6.0)于2个月前进入注册中心。
支持 MCP 的应用,例如 Claude Desktop、Claude Code、Cursor 和 VS Code。你的电脑上还需要有 Node.js, Docker。
同一分类中有:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu
同一分类、其他作者、命令已通过检查。官方的排在前面,再按星标排序。
如何看卡片:↓ 每周下载量i★ GitHub 星标i三大支柱:评价 · 检查 · 使用情况i更新 = 最新版本发布到注册中心的时间i
Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.
Manage monitors, status pages, incidents and maintenances in your openstatus workspace.
Validate oh-my-posh configurations and segment snippets against the official schema.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.
| 本项 wg-easy | World Monitor | openstatus | Oh My Posh Validator | Strata | Jitsu | |
|---|---|---|---|---|---|---|
| 运行位置 | 需要安装在电脑上 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 | 在云端运行,无需安装 |
| 需要密钥 | 是 | 否 | 否 | 否 | 否 | 否 |
| 可在 Claude 中按 + 添加 | 否 | 否 | 否 | 否 | 否 | 否 |
| 基础检查 | 3/3 | 4/4 | 4/4 | 4/4 | 1/4 | 4/4 |
| 许可证 | MIT | AGPL-3.0 | AGPL-3.0 | MIT | Apache-2.0 | MIT |
| 价格 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 | 登记中未列出费用 |
按原文从作者的仓库复制。PopNx MCP 没有审查或背书其内容。HTML、图片和脚本已被移除。链接会离开本站。
A Model Context Protocol (MCP) server for administering wg-easy (WireGuard Easy) instances.
Lets MCP clients like Claude Code, Claude Desktop or Codex manage your WireGuard VPN: list, create, update, enable/disable and delete clients, fetch configuration files and QR codes, and inspect the server status — all through the wg-easy v15 REST API.
Eleven tools is the ceiling, not the floor: WG_EASY_ALLOW_TOOLS=essential registers a curated six instead, and a model picks the right tool far more reliably from six than from eleven — see choosing which tools load.
The full client lifecycle over the wg-easy v15 REST API, including .conf files, QR codes and one-time download links.
Partial updates merge. An update reads the current client state and changes only the fields you named, instead of overwriting the rest with defaults.
`disable_client` stays ungated on purpose. Every other write asks a person first through MCP elicitation; that one only ever withdraws access, and making it harder would be making the safe move the slow one.
Note: The wg-easy REST API is not yet declared stable and may change between releases. This server targets wg-easy v15.
Configuration is provided via environment variables:
| Variable | Required | Description |
|---|---|---|
WG_EASY_URL | yes | Base URL of the wg-easy web UI, e.g. https://vpn.example.com:51821 |
WG_EASY_USERNAME | yes | Username of a wg-easy admin account |
WG_EASY_PASSWORD | yes | Password of that account |
WG_EASY_INSECURE_TLS | no | Set to true to accept self-signed TLS certificates (scoped to the wg-easy connection) |
WG_EASY_ALLOW_TOOLS | no | Comma-separated tool names, list_* prefixes, or essential for a curated preset |
WG_EASY_DENY_TOOLS | no | Same syntax; removed from whatever WG_EASY_ALLOW_TOOLS left |
ELICITATION | no | false replaces the approval dialog with the two-call token. Not prefixed |
Use `https://`. With a plain-
httpURL the Basic Auth credentials and all
WireGuard private keys travel unencrypted; the server prints a warning unless
the host is local. For self-signed certificates prefer a proper internal CA
over
WG_EASY_INSECURE_TLS.
Without credentials the server still starts and lists its tools (so registries and inspectors can introspect it), but every tool call fails with setup instructions instead of reaching the wg-easy API.
WG_EASY_ALLOW_TOOLS and WG_EASY_DENY_TOOLS take comma-separated tool names; a trailing * matches a whole family. essential is a curated preset of six: get_server_info, list_clients, get_client, create_client, enable_client, disable_client.
get_client_config, get_client_qrcode and generate_one_time_link are not in it, and neither is delete_client: all four either destroy something irreversibly or hand out a peer's private key. Name them where you want them.
WG_EASY_ALLOW_TOOLS=essential
WG_EASY_ALLOW_TOOLS=essential,get_client_config WG_EASY_ALLOW_TOOLS=list_clients,get_client_config WG_EASY_DENY_TOOLS=delete_client,create_client
An entry that matches no tool aborts startup and names it, so a typo cannot silently hide a tool — an absent tool is not something anyone traces back to an environment variable. A filtered tool is never registered, so it is absent from tools/list and unknown to tools/call alike, exactly like a write tool under WG_EASY_READ_ONLY.
If you run several of these servers at once, mcp-hub is the other answer — its /hub endpoint replaces every server's tools with six meta-tools.
claude mcp add wg-easy -s user \
-e WG_EASY_URL=https://vpn.example.com:51821 \ -e WG_EASY_USERNAME=admin \ -e WG_EASY_PASSWORD=your-password \ -- npx -y wg-easy-mcp
Add to your claude_desktop_config.json:
{
"mcpServers": { "wg-easy": { "command": "npx", "args": ["-y", "wg-easy-mcp"], "env": { "WG_EASY_URL": "https://vpn.example.com:51821", "WG_EASY_USERNAME": "admin", "WG_EASY_PASSWORD": "your-password" } } } }
Add to your ~/.codex/config.toml:
[mcp_servers.wg-easy]
command = "npx" args = ["-y", "wg-easy-mcp"] env = { WG_EASY_URL = "https://vpn.example.com:51821", WG_EASY_USERNAME = "admin", WG_EASY_PASSWORD = "your-password" }
git clone https://github.com/ni-c/wg-easy-mcp.git
cd wg-easy-mcp npm install npm run build
node /path/to/wg-easy-mcp/dist/index.js as the command
A multi-arch image (linux/amd64, linux/arm64) with an SBOM and build provenance is published to GitHub Container Registry:
docker run -i --rm \
-e WG_EASY_URL=https://vpn.example.com:51821 \ -e WG_EASY_USERNAME=admin \ -e WG_EASY_PASSWORD=your-password \ ghcr.io/ni-c/wg-easy-mcp:latest
The image talks MCP over stdio, so clients need docker run -i (no port is exposed):
{
"mcpServers": { "wg-easy": { "command": "docker", "args": [ "run", "-i", "--rm", "-e", "WG_EASY_URL", "-e", "WG_EASY_USERNAME", "-e", "WG_EASY_PASSWORD", "ghcr.io/ni-c/wg-easy-mcp:latest" ], "env": { "WG_EASY_URL": "https://vpn.example.com:51821", "WG_EASY_USERNAME": "admin", "WG_EASY_PASSWORD": "your-password" } } } }
A client that cannot spawn a local process — ChatGPT connectors, Claude on the web, Cursor, LibreChat — reaches wg-easy-mcp through mcp-hub: one container serves many stdio MCP servers over Streamable HTTP, with an OAuth 2.1 login behind a single password and long-lived tokens for the clients that cannot do OAuth. Its /hub endpoint puts every server behind six meta-tools, so one connector reaches all of them without N×tool schemas in the model's context, and it speaks both protocol revisions — a question this server asks travels through it to the person at the far end.
Its /config/mcp.json uses Claude Code's format, so the entry is the one you already have:
{
"mcpServers": { "wg-easy": { "command": "npx", "args": ["-y", "wg-easy-mcp"], "env": { "WG_EASY_ALLOW_TOOLS": "essential" }, "denyTools": ["delete_client"] } } }
allowTools and denyTools there are the hub's own per-server filter, which is not the same thing as *_ALLOW_TOOLS in env — the difference, and the mistake it invites, are in the client guide.
| Tool | Description |
|---|---|
list_clients | List all WireGuard clients with status and traffic statistics |
get_client | Get the full details of a single client |
create_client 👤 | Create a new client (name, optional expiresAt) |
update_client 👤 | Update a client; only the provided fields are changed |
enable_client 👤 | Let a client connect again — re-arms a key pair already installed on the peer |
disable_client | Block a client; it keeps its configuration and keys |
delete_client 👤 | Permanently delete a client |
get_client_config | Get the client's WireGuard .conf file |
get_client_qrcode | Get the client configuration as a QR code (SVG) |
generate_one_time_link 👤 | Generate a one-time config download link, valid five minutes |
get_server_info | Release/update status, general settings and interface configuration (secrets redacted) |
👤 asks a person through MCP elicitation · falls back to a two-call confirm_token where the client cannot show a dialog.
Every tool declares an outputSchema and answers with structuredContent alongside the text block, so a client can use the result without parsing prose:
{
"untrusted": true, "source": "wg-easy", "count": 2, "clients": [{ "id": 1, "name": "laptop", "enabled": true }], }
The untrusted marker is a field and not only a sentence in the text, because a client that reads th