VPS Ops

Name: VPS Ops
Author: koller-nexus

作者：koller-nexusバージョン 0.1.0i★ –iパソコンで動く

レジストリ名io.github.koller-nexus/vps-ops-mcp

インストール

概要

作者による説明（英語の原文）

Stdio MCP server that inspects and (with confirmation) mutates one VPS over SSH.

PopNx MCPの3つの柱

この3つを1つのスコアにまとめることはしません。意見、測定、人気はそれぞれ別のものだからです。

利用者の声iレビューはまだありませんレビューは今後のステップで、アカウント機能と一緒に始まります
私たちの基本チェックi1項目中1項目に合格公開情報からチェック。コードはまだスキャンしていません
利用状況iとても新しい↓ 42/週 · ★ –

できること

このサーバーのやさしい解説はまだ書いていません。以下はレジストリから読み取った事実です。

接続方法: パソコンで動く
トランスポート: stdio
カテゴリ: 開発者ツール
入力が必要なもの：VPS_SSH_KEY_PATH, VPS_SSH_KEY_PASSPHRASE

インストール

使っているAIアプリを選んで、設定をコピーしてください。

インストールの前に

基本チェック：1項目中1項目に合格
あなたのパソコンで、あなたのユーザーと同じ権限（ファイル、ネットワーク、アプリ）で動きます。
自分で入力するもの： VPS_SSH_KEY_PATH, VPS_HOST, VPS_USER, VPS_PORT, VPS_COMPOSE_DIR, VPS_COMMAND_TIMEOUT_MS, VPS_LOG_MAX_BYTES, VPS_ALLOW_MUTATIONS, VPS_SSH_KEY_PASSPHRASE

「秘密」と表示された値は、あなたのアカウントの鍵です。絶対に人に教えたり、チャットに貼り付けたりしないでください。

必要なもの

npmNode.jsのインストール（npxコマンドに必要）

どのアプリを使っていますか？

ClaudeClaude CodeCursorVS CodeChatGPT

上でアプリを選んでください。選んだアプリを覚えておくので、次からはボタンに「…にインストール」と表示されます。

Claude Desktop → Settings → Developer → Edit Config を開き、claude_desktop_config.json にこれを貼り付けます

{
  "mcpServers": {
    "vps-ops": {
      "command": "npx",
      "args": [
        "-y",
        "@koller-nexus/vps-ops-mcp"
      ],
      "env": {
        "VPS_SSH_KEY_PATH": "your-value",
        "VPS_HOST": "your-value",
        "VPS_USER": "your-value",
        "VPS_PORT": "your-value",
        "VPS_COMPOSE_DIR": "your-value",
        "VPS_COMMAND_TIMEOUT_MS": "your-value",
        "VPS_LOG_MAX_BYTES": "your-value",
        "VPS_ALLOW_MUTATIONS": "your-value",
        "VPS_SSH_KEY_PASSPHRASE": "your-value"
      }
    }
  }
}

ターミナルでこれを実行します

claude mcp add vps-ops --env VPS_SSH_KEY_PATH=your-value --env VPS_HOST=your-value --env VPS_USER=your-value --env VPS_PORT=your-value --env VPS_COMPOSE_DIR=your-value --env VPS_COMMAND_TIMEOUT_MS=your-value --env VPS_LOG_MAX_BYTES=your-value --env VPS_ALLOW_MUTATIONS=your-value --env VPS_SSH_KEY_PASSPHRASE=your-value -- npx -y @koller-nexus/vps-ops-mcp

動かす前に、空欄の値を入力してください。

Cursorで開く

または、設定を自分でコピーする

プロジェクトの .cursor/mcp.json、または ~/.cursor/mcp.json に貼り付けます

{
  "mcpServers": {
    "vps-ops": {
      "command": "npx",
      "args": [
        "-y",
        "@koller-nexus/vps-ops-mcp"
      ],
      "env": {
        "VPS_SSH_KEY_PATH": "your-value",
        "VPS_HOST": "your-value",
        "VPS_USER": "your-value",
        "VPS_PORT": "your-value",
        "VPS_COMPOSE_DIR": "your-value",
        "VPS_COMMAND_TIMEOUT_MS": "your-value",
        "VPS_LOG_MAX_BYTES": "your-value",
        "VPS_ALLOW_MUTATIONS": "your-value",
        "VPS_SSH_KEY_PASSPHRASE": "your-value"
      }
    }
  }
}

ブラウザがアプリを開いてよいか確認し、そのあとアプリが設定を表示して確認を求めます。キーの値は空欄のままなので、自分で入力してください。

VS Codeで開く

または、設定を自分でコピーする

プロジェクトの .vscode/mcp.json に貼り付けます

{
  "servers": {
    "vps-ops": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@koller-nexus/vps-ops-mcp"
      ],
      "env": {
        "VPS_SSH_KEY_PATH": "your-value",
        "VPS_HOST": "your-value",
        "VPS_USER": "your-value",
        "VPS_PORT": "your-value",
        "VPS_COMPOSE_DIR": "your-value",
        "VPS_COMMAND_TIMEOUT_MS": "your-value",
        "VPS_LOG_MAX_BYTES": "your-value",
        "VPS_ALLOW_MUTATIONS": "your-value",
        "VPS_SSH_KEY_PASSPHRASE": "your-value"
      }
    }
  }
}

これはパソコンで動くサーバーですが、ChatGPTがつなげるのはインターネット上のサーバーだけです。ほかのアプリを選んでください。

選んだアプリは、この端末のCookieに保存されます。アカウントは不要です。

自分で入力する値

VPS_SSH_KEY_PATH 秘密必須 env
Absolute path to a readable SSH private key
VPS_HOST env
SSH hostname of the single target VPS
VPS_USER env
SSH username
VPS_PORT env
SSH port
VPS_COMPOSE_DIR env
Absolute Compose directory on the remote host
VPS_COMMAND_TIMEOUT_MS env
Remote command timeout in milliseconds
VPS_LOG_MAX_BYTES env
Stdout/stderr byte cap for remote commands
VPS_ALLOW_MUTATIONS env
Set false to reject every mutation tool
VPS_SSH_KEY_PASSPHRASE 秘密 env
Optional key passphrase; prefer ssh-agent instead

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

できること

パソコンで動くサーバーです。インストールすると、ツール一覧がAIアプリに表示されます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月8日にチェック

✓ 合格
作者とリポジトリが一致
レジストリ名は、リポジトリを所有するGitHubアカウント koller-nexus で確認済みです
… 未チェック
今もメンテナンスされている
このリポジトリはまだGitHubから読み取っていません
… 未チェック
ライセンスがある
このリポジトリはまだGitHubから読み取っていません
– 対象外
エンドポイントが応答する
これはパソコンで動くため、インターネット上のエンドポイントはありません
– 対象外
OAuthでサインイン
パソコンで動き、代わりにローカルの設定を使います
… 未チェック
ツールの説明に隠れた指示がない
パソコンで動くサーバーです。ツール一覧を読み取れるのは、インターネット上のエンドポイントがある場合だけです

開発者ツールのほかのサーバーとの比較i

このカテゴリのほかの4937件のうち0%よりスターが多い
このカテゴリのほかの4937件のうち50%より最近レジストリに公開
基本チェックの結果が、このカテゴリのほかの4937件のうち100%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

VPS Opsは安全ですか？

当てはまる基本チェック1項目のうち1項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか？

入力が必要なもの：VPS_SSH_KEY_PATH, VPS_SSH_KEY_PASSPHRASE

パソコンで動きますか、それともクラウドですか？

あなたのパソコンで動きます。必要なときにAIアプリが起動し、データは作者のサーバーを通りません（サーバー自体がオンラインサービスを呼び出す場合を除きます）。

今もメンテナンスされていますか？

GitHubリポジトリの最終更新は–、最新バージョン（0.1.0）がレジストリに届いたのは2 か月前です。

どのアプリで使えますか？

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。パソコンにNode.jsも必要です。

代わりに使えるものは？

同じカテゴリには：GitHub, Desktop Commander, Cloudflare MCP

代わりの候補

同じカテゴリで、ほかの作者が作ったサーバー。スターの多い順。

カードの見方：↓ 週あたりのダウンロードi★ GitHubスターi3つの柱：レビュー · チェック · 利用状況i更新＝最新バージョンをレジストリに公開した日i

GitHub

Connect AI assistants to GitHub - manage repos, issues, PRs, and workflows through natural language.

作者：github広く使われている★ 3.4万5 日前更新

パソコンでもクラウドでも

インストール

Desktop Commander

MCP server for terminal commands, file operations, and process management

作者：wonderwhy-er広く使われている↓ 71万/週★ 1万17 日前更新

パソコンで動く

インストール

Cloudflare MCP

Cloudflare MCP servers

作者：cloudflare成長中★ 444614 か月前更新

クラウドで動く✓ mcp.cloudflare.com

インストール

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

vps-ops-mcp

A stdio MCP server that operates one VPS over SSH. Cursor and Codex start the process with bun and call read-only tools (host health, Unix debug, Docker, Compose, Swarm, firewall) plus mutation tools (restart, stop, start, prune). Mutations require an explicit confirmation.

Transport is stdio. Do not start the server as a long-lived process by hand: the client (Cursor or Codex) launches it.

Contributing

See CONTRIBUTING.md (branches, pull requests, verification) and ISSUE.md (how to file an issue).

Requirements

Bun
Python 3 (used by the registration scripts)
OpenSSH client (ssh on PATH)
A readable SSH private key with access to the remote user
On the remote host: Docker (and passwordless sudo -n for ufw, fail2ban, sshd -T, ss, and dmesg if you use those tools)

Configuration

cp .env.example .env

Edit .env. The file is gitignored.

Variable	Required	Default	Purpose
`VPS_SSH_KEY_PATH`	yes	—	Absolute path to the private key. The process refuses to start if the file is missing or unreadable.
`VPS_HOST`	no	`vps.example.invalid`	SSH host (placeholder; set your own host).
`VPS_USER`	no	`ubuntu`	SSH user.
`VPS_PORT`	no	`22`	SSH port.
`VPS_COMPOSE_DIR`	no	—	Absolute Compose directory on the VPS. Without it, Compose tools require the `dir` argument.
`VPS_COMMAND_TIMEOUT_MS`	no	`30000`	Remote command timeout. Expiry returns `exit_code` 124.
`VPS_LOG_MAX_BYTES`	no	`200000`	Cap for `stdout`/`stderr`. Overflow is cut and `truncated` is `true`.
`VPS_ALLOW_MUTATIONS`	no	`true`	`false`, `0`, `no`, or `off` disables every mutation.
`VPS_SSH_KEY_PASSPHRASE`	no	—	Avoid. Prefer `ssh-agent`. Registration scripts do not copy this variable into the client.

VPS_COMPOSE_DIR must be absolute and match /^[a-zA-Z0-9/_.-]+$/ (it must start with /).

Installation

bun install

npm package (requires Bun; the MCP Registry points at this artifact):

bunx @koller-nexus/vps-ops-mcp

MCP Registry name: io.github.koller-nexus/vps-ops-mcp. The registry publishes metadata only after the package exists on public npm.

Register with clients

The scripts write MCP config from variables already exported in the shell. They do not load .env themselves. If you skip the export, the scripts fall back to their defaults (host, user, port, and a local key path).

Do this once at the repository root before each script:

set -a

source .env set +a

Each run backs up the destination file (*.bak.YYYYMMDDHHMMSS) and replaces only the vps-ops server. Other MCP servers stay in place.

Optional script variables:

Variable	Default	Purpose
`MCP_PROJECT_DIR`	this repository root	Source of the `src/index.ts` path.
`CURSOR_MCP_JSON`	`~/.cursor/mcp.json`	Cursor file to update.
`CODEX_CONFIG`	`~/.codex/config.toml`	Codex file to update.

VPS_COMPOSE_DIR is written into the client config only when it is set and non-empty.

Cursor

Global registration (applies in every workspace):

./scripts/register-cursor-mcp.sh

The script writes ~/.cursor/mcp.json in this shape:

"mcpServers": { "vps-ops": { "command": "bun", "args": ["/absolute/path/vps-ops-mcp/src/index.ts"], "env": { "VPS_HOST": "your.host", "VPS_USER": "ubuntu", "VPS_PORT": "22", "VPS_SSH_KEY_PATH": "/absolute/path/to/key", "VPS_COMMAND_TIMEOUT_MS": "30000", "VPS_LOG_MAX_BYTES": "200000", "VPS_ALLOW_MUTATIONS": "true" } } } }

To scope it to one project, point the script at that project's mcp.json:

CURSOR_MCP_JSON="/absolute/path/to/project/.cursor/mcp.json" ./scripts/register-cursor-mcp.sh

Then reload the Cursor window (Command Palette → Developer: Reload Window) or restart the server under Settings → MCP. The server appears as vps-ops.

Codex

./scripts/register-codex-mcp.sh

The script writes ~/.codex/config.toml:

[mcp_servers.vps-ops]

command = "bun" args = ["/absolute/path/vps-ops-mcp/src/index.ts"]

[mcp_servers.vps-ops.env] VPS_HOST = "your.host" VPS_USER = "ubuntu" VPS_PORT = "22" VPS_SSH_KEY_PATH = "/absolute/path/to/key" VPS_COMMAND_TIMEOUT_MS = "30000" VPS_LOG_MAX_BYTES = "200000" VPS_ALLOW_MUTATIONS = "true"

Close and reopen the Codex session so it rereads config.toml. If the CLI is on PATH, codex mcp list should show vps-ops.

Verify

Test SSH outside MCP with the same flags the server uses:

ssh -i "$VPS_SSH_KEY_PATH" \

-o BatchMode=yes \ -o IdentitiesOnly=yes \ -o StrictHostKeyChecking=accept-new \ -p "${VPS_PORT:-22}" \ "${VPS_USER}@${VPS_HOST}" \ 'uname -a'

In Cursor or Codex, ask the client to call vps_ping. The response is JSON:

"exit_code": 0, "stdout": "...", "stderr": "", "duration_ms": 0, "truncated": false }

A non-zero exit_code is an MCP error. If the process exits immediately with VPS_SSH_KEY_PATH is required or missing or unreadable, the variable never reached the client env — rerun the registration script with .env exported.

Tools

Every call returns exit_code, stdout, stderr, duration_ms, and truncated.

Read-only

Tool	Arguments	What it does
`vps_ping`	—	`uname -a`, `uptime`, `hostname`.
`vps_resources`	—	`df -h`, `free -h`, load average.
`vps_journal`	`unit`, `n?` (1–500, default 100)	`journalctl -u`. Unit from the allowlist (`docker`, `sshd`, `fail2ban`, `ufw`, `cron`, with or without `.service`) or a safe name ending in `.service`.
`docker_ps`	—	`docker ps -a` as JSON lines.
`docker_inspect`	`name`	`docker inspect`.
`docker_logs`	`name`, `n?` (1–1000, default 200), `since?`	`docker logs --tail --timestamps`.
`docker_stats`	—	`docker stats --no-stream`.
`docker_service_ls`	—	`docker service ls` em JSON lines (Swarm).
`docker_node_ls`	—	`docker node ls` em JSON lines (Swarm).
`compose_ps`	`dir?`, `file?`	`docker compose ps` em `dir` ou `VPS_COMPOSE_DIR` (`file`, ex. `stack.yml`, vira `-f`).
`compose_config_vars`	`dir?`, `file?`	Renderiza o stack (`docker compose config`) e devolve só os nomes das variáveis de ambiente por serviço, nunca os valores.
`host_deps`	—	Versões de `docker`, `docker compose` (v2) e `jq`.
`host_listen`	—	`ss -lntup` (`sudo -n`, senão sem sudo).
`host_failed_units`	—	`systemctl --failed --no-pager --full`.
`host_top`	—	Top 30 processes by memory (`ps aux --sort=-%mem`).
`host_dmesg`	`n?` (1–200, default 100)	`dmesg -T` + `tail` (`sudo -n`, otherwise without sudo).
`host_firewall`	—	`ufw status verbose` (`sudo -n`, otherwise without sudo).
`host_fail2ban`	`jail?`	`fail2ban-client status` (`sudo -n`).
`ssh_hardening_check`	—	Filtered `sshd -T`: port, password, root login, pubkey.

Container, service, image, and jail names must match ^a-zA-Z0-9*$.

Mutation

These require confirm: true. With VPS_ALLOW_MUTATIONS=false, all of them are rejected.

Tool	Extra arguments	Remote command
`docker_restart`	`name`	`docker restart`
`docker_stop`	`name`	`docker stop`
`docker_start`	`name`	`docker start`
`compose_up`	`dir?`, `services?`	`docker compose up -d`
`compose_restart`	`dir?`, `services?`	`docker compose restart`
`compose_pull_up`	`dir?`, `services?`	`docker compose pull` then `up -d`
`docker_rm`	`name`, `force_name`	`docker rm -f`. `force_name` must equal `name`.
`disk_cleanup_docker`	`confirm_volumes?`	`docker system prune -f`. Volumes only with `confirm_volumes: true`.

Security

Remote commands are fixed. There is no free-form shell tool.
Name and path arguments go through an allowlist and are quoted in the shell.
SSH uses BatchMode=yes, IdentitiesOnly=yes, and StrictHostKeyChecking=accept-new.
A mutation without confirm: true is rejected. docker_rm asks for the name twice. Volume prune requires confirm_volumes: true.
For a read-only client, register with VPS_ALLOW_MUTATIONS=false.

VPS Ops

概要

PopNx MCPの3つの柱

できること

インストール

インストールの前に

自分で入力する値

できること

基本チェックi

作者とリポジトリが一致

今もメンテナンスされている

ライセンスがある

エンドポイントが応答する

OAuthでサインイン

ツールの説明に隠れた指示がない

開発者ツールのほかのサーバーとの比較i

よくある質問

代わりの候補

GitHub

Desktop Commander

Cloudflare MCP

作者のREADME

vps-ops-mcp

Contributing

Requirements

Configuration

Installation

Register with clients

Cursor

Codex

Verify

Tools

Read-only

Mutation

Security