Kasm MCP Server v2
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
Kasm MCP Server v2
A Model Context Protocol (MCP) server that enables AI agents to manage and interact with Kasm Workspaces containerized desktop infrastructure. This server provides a standardized interface for LLMs to create, manage, and execute commands within Kasm sessions.
π Quick Start
# Clone the repository
git clone https://github.com/roguedev-ai/kasm-mcp-server-v2.git
cd kasm-mcp-server-v2
# Run the automated setup script
./setup-prerequisites.sh
# Choose option 1 for NPM/Python mode (recommended for Cline)
# Configure your Kasm API credentials when prompted
# Start the server
source venv/bin/activate
python -m srcRelated MCP server: vighnesh-agentic-terminal-mcp
π Documentation
Quick Start Guide - Get up and running in 5 minutes
Installation Guide - Detailed installation instructions
Tool Reference - Complete reference for all 21 available tools
Suggested Prompts - Example prompts for effective usage
Troubleshooting Guide - Common issues and solutions
Cline Integration Guide - Configure Cline to use this MCP server
LLM Integration Guide - Integrate with any MCP-compatible LLM
Architecture Documentation - System design and components
Security Documentation - Security features and best practices
β¨ Features
π§ Session Management - Create, destroy, and monitor Kasm workspace sessions
π» Command Execution - Execute commands inside Kasm containers with security boundaries
π File Operations - Read and write files within Kasm sessions
π₯ User Management - Create and manage Kasm users
π Security - MCP Roots security mechanism for safe file operations
π Multiple Deployment Options - NPM/Python or Docker deployment
π οΈ Available Tools
The server provides 21 tools organized into categories:
Session Management (8 tools)
create_kasm_session- Launch a new Kasm workspacedestroy_kasm_session- Terminate a sessionget_session_status- Check session statuslist_user_sessions- List your active sessionslist_all_sessions- List all system sessions (admin)pause_kasm_session- Pause a session to free resourcesresume_kasm_session- Resume a paused sessionget_session_screenshot- Capture session screenshot
Command & File Operations (3 tools)
execute_kasm_command- Execute shell commands in sessionsread_kasm_file- Read file contents from sessionswrite_kasm_file- Write content to files in sessions
User Management (6 tools)
get_kasm_users- List all userscreate_kasm_user- Create new user accountsget_kasm_user- Get specific user detailsupdate_kasm_user- Update user informationdelete_kasm_user- Remove users from systemlogout_kasm_user- Logout all user sessions
Monitoring & Performance (3 tools)
get_session_frame_stats- Frame rendering statisticsget_session_bottleneck_stats- CPU/network bottleneck analysisget_session_recordings- Access session recordings
System Information (1 tool)
get_available_workspaces- List available workspace images
See the Tool Reference for complete details on all tools.
π¦ Installation Options
Option 1: Automated Setup (Recommended)
Use the setup-prerequisites.sh script for automated installation:
./setup-prerequisites.shChoose from:
NPM/Python Mode - Direct execution with npm support (best for Cline)
Docker Mode - Containerized deployment
Both - Install prerequisites for both modes
Option 2: Manual Installation
See the Installation Guide for manual setup instructions.
π§ Configuration
Create a .env file with your Kasm credentials:
KASM_API_URL=https://your-kasm-instance.com
KASM_API_KEY=your_api_key_here
KASM_API_SECRET=your_api_secret_here
KASM_USER_ID=default
KASM_ALLOWED_ROOTS=/home/kasm-user
LOG_LEVEL=INFOπ§ͺ Testing
Run the diagnostic test to verify your installation:
python test_server.pyπ Troubleshooting
Recent Fixes
FastMCP Initialization Error - Fixed in commit c95882e (see MCP_SDK_COMPATIBILITY_FIX.md)
Import Issues - Resolved with official MCP SDK migration
Common Issues
"No module named 'mcp'" - Install the MCP SDK:
pip install mcpEnvironment variables not set - Check your
.envfile configurationServer won't start - Run
python test_server.pyfor diagnostics
π€ Contributing
Contributions are welcome! Please read our contributing guidelines and submit pull requests to the repository.
π License
This project is licensed under the MIT License - see the LICENSE file for details.
π Resources
π§ Support
For issues and questions:
Open an issue on GitHub
Check existing documentation in the
/docsfolderReview the troubleshooting section above
Current Version: 2.0.1
Last Updated: September 10, 2025
Status: β
Production Ready
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
This server cannot be deployed
Maintenance
Related MCP Connectors
Your org's AI agents, tasks, runs, search, and brain files as MCP tools and resources.
Persistent cloud workspaces for AI agents: run commands, edit files, use git and a browser.
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Related MCP Servers
- AlicenseDqualityDmaintenanceEnables AI assistants to interact with local Docker containers, Kubernetes clusters, and system logs using the Model Context Protocol.9ISC
- FlicenseBqualityCmaintenanceEnables AI agents to execute terminal commands and Python scripts, search and manage files, and create or delete folders through the Model Context Protocol.9-
- AlicenseBqualityBmaintenanceEnables LLMs to manage Kasm Workspaces sessions, including creating, destroying, pausing, resuming, screenshotting, dispatching commands, and sharing view-only links, with opt-in administration of users, groups, and registries.10MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to access file systems, fetch web content, query databases, and execute shell commands through the standardized Model Context Protocol.MIT