VeryCloud MCP

Connect a VeryCloud/Wisp game server to MCP-compatible AI clients such as ChatGPT, Claude Code, and Cursor.

VeryCloud MCP lets an AI assistant inspect your server, read logs and configuration files, send console commands, manage files, and control server power through the VeryCloud Client API. Your VeryCloud API token stays on the machine hosting the MCP server and is never meant to be pasted into prompts or committed to Git.

Project status: development preview (0.2.x). Read-only tools are usable. Write/power tools are opt-in. Remote authentication and live-console streaming are still being finalized before a production-ready release.

What you can do

Available now

• List servers available to your VeryCloud account

• Read server details and resource usage

• Check CPU, RAM, disk, network, power state, and game-query information

• Browse server directories

• Read text files, configuration files, plugins, and logs

• Send console commands when enabled

• Start, stop, or restart the server when enabled

• Write, copy, and rename files when enabled

• Delete files or force-kill only when destructive access is explicitly enabled

Planned before the first production release

• Authenticated remote deployment suitable for ChatGPT

• Internal WebSocket console/log streaming without exposing temporary VeryCloud credentials to the AI client

• Backup and audit-log tools

• End-to-end tests against a real VeryCloud deployment

• Release images and simpler one-command deployment

Related MCP server: Simple SSH MCP Server

Security defaults

The server starts in least-privilege mode. All modifying capabilities are disabled unless the operator explicitly enables them.

VERYCLOUD_ALLOW_COMMANDS=false
VERYCLOUD_ALLOW_FILE_WRITES=false
VERYCLOUD_ALLOW_POWER=false
VERYCLOUD_ALLOW_DESTRUCTIVE=false

Keep VERYCLOUD_ALLOW_DESTRUCTIVE=false unless you specifically need destructive operations.

Configuration

Copy .env.example to .env on the machine that will run VeryCloud MCP, then edit it locally:

VERYCLOUD_PANEL_URL=https://panel.verycloud.fr
VERYCLOUD_SERVER_ID=e8a83c9b
VERYCLOUD_API_TOKEN=your_private_token
VERYCLOUD_TIMEOUT=30

VERYCLOUD_ALLOW_COMMANDS=false
VERYCLOUD_ALLOW_FILE_WRITES=false
VERYCLOUD_ALLOW_POWER=false
VERYCLOUD_ALLOW_DESTRUCTIVE=false

Never commit .env or a real token.

Run locally

Requirements: Python 3.11 or newer.

python -m venv .venv
python -m pip install -e .
verycloud-mcp

The MCP endpoint is exposed through Streamable HTTP at /mcp.

Docker

docker build -t verycloud-mcp .
docker run --rm -p 8000:8000 --env-file .env verycloud-mcp

The container runs as a non-root user.

Connect an MCP client

Claude Code

For a local instance:

claude mcp add --transport http verycloud http://localhost:8000/mcp

Cursor

Add http://localhost:8000/mcp as a Streamable HTTP MCP server in Cursor's MCP settings.

ChatGPT

ChatGPT connects to remote MCP servers rather than a normal localhost endpoint. Do not expose the current development build directly to the public internet. Production deployment instructions will be added once MCP-layer authentication is complete.

Important limitations

• This project is not yet a finished hosted service; you must run the MCP server somewhere.

• Live WebSocket console streaming is not enabled yet. Logs can currently be read through the VeryCloud file API and commands can be sent through the Client API.

• VeryCloud MCP is an independent community project and is not affiliated with or endorsed by VeryCloud or Wisp.

Contributing

Contributions are welcome. See CONTRIBUTING.md for the development rules and test requirements.

License

Source-available for non-commercial use only under the PolyForm Noncommercial License 1.0.0. Commercial use, resale, paid hosting, or monetization requires separate written permission from the copyright holder. See LICENSE.