EZSCALE/virtfusion-mcp
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases 2 Wiki Activity
Page: Changelog
Pages
API-Coverage Architecture Changelog Contributing Getting-Started Home Tool-Reference
Clone
1
Changelog
Prophet731 edited this page 2026-03-16 00:33:57 -04:00
Table of Contents

Changelog

All notable changes to the VirtFusion MCP Server are documented here. This project follows Semantic Versioning.

v1.0.1

Release date: 2026-03-16

Bug Fixes

  • servers_throttle_cpu: Fixed the request body to send percent instead of cpuThrottle to match the VirtFusion API specification.
  • servers_delete: Enforced a minimum 300-second (5-minute) delay on all server deletions as a safety margin to prevent accidental destruction. The delay parameter now floors at 300 even if a lower value is provided.

Other

  • Version bump in package.json to 1.0.1.

v1.0.0

Release date: 2026-03-15

Initial Release

Complete MCP server wrapping all 84 VirtFusion Admin API endpoints.

Features

  • 84 tools across 17 modules covering the entire VirtFusion Admin API
  • Core HTTP client (VirtFusionClient) with Bearer token authentication, query parameter filtering, and structured error handling
  • Tool modules organized by API category:
    • General (1 tool)
    • Servers (18 tools) -- create, build, delete, suspend, unsuspend, modify, VNC, custom XML, change owner/package, backup plans
    • Servers Power (4 tools) -- boot, shutdown, restart, poweroff
    • Servers Network (5 tools) -- IPv4 management, whitelist
    • Servers Firewall (4 tools) -- get, enable, disable, set rules
    • Servers Traffic (4 tools) -- traffic blocks, modify allowance
    • Hypervisors (2 tools) -- list, get
    • Hypervisor Groups (3 tools) -- list, get, get resources
    • IP Blocks (3 tools) -- list, get, add IPv4 range
    • Packages (2 tools) -- list, get
    • Queue (1 tool) -- get item status
    • Backups (1 tool) -- list by server
    • DNS (1 tool) -- get service
    • Media (2 tools) -- get ISO, get templates by package
    • SSH Keys (4 tools) -- create, get, delete, list by user
    • Users (7 tools) -- create, get, modify, delete, reset password, generate auth tokens
    • Self Service (19 tools) -- credit, currencies, group profiles, resource packs, hourly stats, access, reports, usage, pack server management
  • Endpoint drift detection -- Scripts and CI workflow to detect when VirtFusion adds new API endpoints
  • Multiple installation methods -- npx from git URL, global npm install, or build from source
  • MCP client configuration examples -- Claude Desktop, Claude Code, VS Code/Cursor
  • Gitea Actions CI/CD -- Build, endpoint sync, release automation, version check
  • CLAUDE.md for AI assistant onboarding

For the full tool list, see Tool-Reference. For project structure details, see Architecture.