VixMCP.Ai.Bridge
About
An MCP server that exposes VMware VIX operations for AI assistants and automation workflows.
Details
- Author
- bivex
- Categories
- Cloud Service, Infrastructure
Jump to
Usage Through AI Assistants (Cursor IDE, etc.)
Using this MCP server through AI assistants like Cursor IDE is compliant with VMware's SDK Agreement as long as:
- The underlying purpose remains "creating software that communicates with VMware Software"
- Users have properly licensed VMware products (Workstation Pro/Player, vSphere, etc.)
- The VIX SDK components are obtained through official VMware channels
- No reverse engineering or unauthorized modifications are performed
- The AI assistant is simply automating legitimate VM management tasks
This integration does not change the licensing requirements - users must still comply with all VMware SDK Agreement terms.
#VMware#VIX#DotNet#CSharp#ModelContextProtocol#MCP#AI#Automation#VirtualMachine#VMAutomation#AIAssistant#CursorIDE#DevTools#Virtualization#WindowsDevelopment#SDK#API#CloudComputing#Infrastructure#DevOps
- ](https://github.com/bivex/VixMCP.Ai.Bridge/blob/HEAD/EXAMPLES.md)Usage Examples with Screenshots- Real-world demonstrations
- VMware VIX API Documentation
- Model Context Protocol Specification
- [.NET 9.0 Documentation
- Check the troubleshooting section above
- Review VMware VIX API documentation
- Create an issue in this repository
Navigate your Aiven projects and interact with the PostgreSQL®, Apache Kafka®, ClickHouse® and OpenSearch® services
Yunxiao MCP Server provides AI assistants with the ability to interact with the Yunxiao platform.
Get prescriptive CDK advice, explain CDK Nag rules, check suppressions, generate Bedrock Agent schemas, and discover AWS Solutions Constructs patterns.
This AWS Labs Model Context Protocol (MCP) server for CloudTrail enables your AI agents to query AWS account activity for security investigations, compliance auditing, and operational troubleshooting.
Core AWS MCP server providing prompt understanding and server management capabilities.
Analyze CDK projects to identify AWS services used and get pricing information from AWS pricing webpages and API.
Query and analyze your Axiom logs, traces, and all other event data in natural language
Manage and interact with Microsoft Azure services.
🖥️ .NET Bindings for VMware VIX API and MCP Integration
🚀Powerful VMware virtual machine automation through AI-driven Model Context Protocol integration
Keywords:VMware VIX•Model Context Protocol•.NET 9.0•AI Automation•Virtual Machine Management•Cursor IDE•C# Bindings
This repository contains .NET bindings for the VMware VIX (Virtual Infrastructure eXtension) API and a Model Context Protocol (MCP) server implementation for VM management operations.
VMware VIX API .NET Library
A comprehensive .NET 9.0 library providing C# bindings for the VMware VIX API, enabling programmatic control of VMware virtual machines.
Model Context Protocol Server
A .NET 9.0 console application implementing an MCP server that exposes VMware VIX operations as tools for AI assistants and automation workflows.
- Complete VIX API Coverage: Full P/Invoke declarations for VMware VIX API
- VM Lifecycle Management: Power on/off, suspend, reset operations
- Guest OS Operations: File transfer, command execution, process management
- Snapshot Management: Create, revert, and manage VM snapshots
- Shared Folders: Configure and manage host-guest shared directories
- Error Handling: Comprehensive error checking and reporting
- Helper Utilities: Simplified command execution and file operations
- Session Management: Persistent VM connections for multiple operations
- Guest Command Execution: Run commands in guest OS and retrieve output
- Process Monitoring: List and manage processes in guest VMs
- Connection Testing: Validate VM connectivity and guest access
- MCP Protocol: Standard Model Context Protocol for AI integration
- Windows 10/11 (x64)
- .NET 9.0 Runtime
- VMware Workstation Pro/Player or VMware vSphere
- VMware VIX API (Vix64AllProductsDyn.dll)
- Download and install VMware VIX API SDKfrom VMware's official website
- Accept the VMware SDK Agreementduring SDK installation
- Install VMware Workstation Pro/Player or connect to vSphere
- Ensure target VMs have VMware Tools installed
- Configure guest OS with appropriate user accounts
- CopyVix64AllProductsDyn.dllfrom the VIX SDK to the application directory
Note: The VIX DLL is not included in this repository and must be obtained from VMware's official SDK distribution.
# Clone the repository git clone <repository-url> cd dotnet-bindings # Build VixBindings library cd VixBindings dotnet build # Build MCP server cd ../McpProcessToolSample dotnet build
The MCP server will start with stdio transport, ready to receive MCP protocol messages.
To integrate the MCP server with Cursor IDE, add the following configuration to your MCP settings file (~/.cursor/mcp.jsonorC:\Users\{Username}\.cursor\mcp.json):
{ "mcpServers": { "mcpWinAuditServer": { "command": "cmd", "args": [ "/c", "C:\\path\\to\\your\\McpProcessToolSample.exe" ] } } }
- Build the McpProcessToolSample project:dotnet build -c Release
- Note the output path ofMcpProcessToolSample.exe
- Update the path in the MCP configuration file
- Restart Cursor IDE to load the MCP server
- The VMware VIX tools will be available in Cursor's AI assistant
Note: Ensure the VIX DLL (Vix64AllProductsDyn.dll) is in the same directory as the executable or in your system PATH.
using VixBindings; // Basic VM connection example var hostHandle = VixApi.VixHost_Connect(/ connection parameters /); var vmHandle = VixApi.VixHost_OpenVM(hostHandle, "path/to/vm.vmx", /.../); // Wait for VMware Tools and login VixApi.VixVM_WaitForToolsInGuest(vmHandle, 600, /.../); VixApi.VixVM_LoginInGuest(vmHandle, "username", "password", /.../); // Execute command in guest var result = VixApiHelper.RunGuestCommandAndGetOutput( vmHandle, "ps aux", "/tmp/output.txt", "C:\\temp\\output.txt" );
Establishes a persistent session with a VM and guest OS.
- hostName: VMware host address
- hostPort: Connection port
- hostUserName: Host authentication username
- hostPassword: Host authentication password
- vmxFilePath: Path to VM configuration file
- guestUserName: Guest OS username
- guestPassword: Guest OS password
Executes commands in the guest OS using an active session.
- command: Command to execute
- guestTempPath: Temporary directory in guest (default:/tmp)
- hostTempPath: Temporary directory on host (default:C:\\temp)
Lists all running processes in the guest VM.
- guestTempPath: Temporary directory in guest
- hostTempPath: Temporary directory on host
Tests connectivity and authentication without maintaining a session.
Once configured in Cursor IDE, you can use natural language to interact with VMware VMs:
- "Connect to my Ubuntu VM and list all running processes"
- "Execute 'df -h' command in the guest OS to check disk usage"
- "Check if I can connect to the VM with these credentials"
- "Run a system update command in the guest VM"
The AI assistant will automatically use the appropriate MCP tools based on your requests, handling VM connections, command execution, and result parsing.
See real-world examples of the MCP server in action:View Examples →
- 🔗 VM connection through natural language
- ⏱️ System monitoring commands
- 👤 User privilege checking
- 💾 Disk usage analysis
- 🤖 AI-driven automation workflow
<PackageReference Include="System.Text.Encoding.CodePages" Version="9.0.6" />
<PackageReference Include="Microsoft.Extensions.Hosting" Version="9.0.6" /> <PackageReference Include="ModelContextProtocol" Version="0.3.0-preview.1" /> <ProjectReference Include="..\VixBindings\VixBindings.csproj" />
- ObtainVix64AllProductsDyn.dllfrom the official VMware VIX SDK and place it in the application directory
- Configure appropriate temporary directories for file operations
- Set up guest OS user accounts with necessary permissions
- Ensure compliance with VMware SDK Agreement terms
The library provides comprehensive error handling through:
- VIX error code translation to human-readable messages
- Structured error responses in MCP tools
- Timeout handling for long-running operations
- Resource cleanup and handle management
- Store VM credentials securely (avoid hardcoding)
- Use least-privilege accounts for guest operations
- Validate and sanitize command inputs
- Monitor temporary file cleanup
- Consider network security for remote VM connections
- Ensure VMware Tools are installed and running in guest
- Check guest OS power state
- Verify guest credentials are correct
- Check guest OS user account permissions
- Ensure interactive login is allowed
- Verify VIX DLL is in the correct location
- Check temporary directory permissions
- Validate VM file paths
- Fork the repository
- Create a feature branch
- Make your changes
- Add tests if applicable
- Submit a pull request
The .NET bindings and MCP server implementation in this repository are provided as-is for educational and development purposes.
IMPORTANT: This project uses the VMware VIX API, which is subject to the VMware Software Developer Kit (SDK) Agreement. Key points:
- The VIX API SDK is provided "AS IS" without warranties
- You may use it to create software that communicates with VMware products
- Redistributable Code must be distributed in object code form only
- You cannot reverse engineer or create derivative works of the Redistributable Code
- VMware retains all intellectual property rights to the SDK
- No VMware support is provided for SDK usage
- You cannot represent your software as certified by VMware
- VMware trademarks cannot be used without permission
- Download the official VIX API SDKfrom VMware's website
- Review and acceptthe complete VMware SDK Agreement
- Ensure you havethe properVix64AllProductsDyn.dllfrom the official SDK
- Comply with allredistribution and usage restrictions
- Do not redistributethe VMware SDK components separately
This repository does not include VMware's proprietary VIX API components. Users must obtain these directly from VMware and comply with VMware's licensing terms. The authors of this repository are not responsible for any licensing violations or improper use of VMware's intellectual property.
Usage Through AI Assistants (Cursor IDE, etc.)
Using this MCP server through AI assistants like Cursor IDE is compliant with VMware's SDK Agreement as long as:
- The underlying purpose remains "creating software that communicates with VMware Software"
- Users have properly licensed VMware products (Workstation Pro/Player, vSphere, etc.)
- The VIX SDK components are obtained through official VMware channels
- No reverse engineering or unauthorized modifications are performed
- The AI assistant is simply automating legitimate VM management tasks
This integration does not change the licensing requirements - users must still comply with all VMware SDK Agreement terms.
#VMware#VIX#DotNet#CSharp#ModelContextProtocol#MCP#AI#Automation#VirtualMachine#VMAutomation#AIAssistant#CursorIDE#DevTools#Virtualization#WindowsDevelopment#SDK#API#CloudComputing#Infrastructure#DevOps
- Usage Examples with Screenshots- Real-world demonstrations
- VMware VIX API Documentation
- Model Context Protocol Specification
- .NET 9.0 Documentation
- Check the troubleshooting section above
- Review VMware VIX API documentation
- Create an issue in this repository
Navigate your Aiven projects and interact with the PostgreSQL®, Apache Kafka®, ClickHouse® and OpenSearch® services
Yunxiao MCP Server provides AI assistants with the ability to interact with the Yunxiao platform.
Get prescriptive CDK advice, explain CDK Nag rules, check suppressions, generate Bedrock Agent schemas, and discover AWS Solutions Constructs patterns.
This AWS Labs Model Context Protocol (MCP) server for CloudTrail enables your AI agents to query AWS account activity for security investigations, compliance auditing, and operational troubleshooting.
Core AWS MCP server providing prompt understanding and server management capabilities.
Analyze CDK projects to identify AWS services used and get pricing information from AWS pricing webpages and API.
Query and analyze your Axiom logs, traces, and all other event data in natural language
Manage and interact with Microsoft Azure services.
Bastion: External Attack Surface Monitoring
Ask your AI assistant about your attack surface: run scans, catch expiring certificates and domains, triage findings, and generate reports.
Agent-ready global image CDN that AI agents can install and operate through MCP.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
