Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CLUSTER_DNS | No | DNS server for IP detection | 8.8.8.8 |
| CLUSTER_GATEWAY | No | Gateway IP for route detection | 192.168.1.1 |
| CLUSTER_SSH_USER | No | SSH username for remote execution | marc |
| AGENTIC_SYSTEM_PATH | No | Base path for databases | /mnt/agentic-system |
| CLUSTER_CMD_TIMEOUT | No | Command execution timeout (seconds) | 300 |
| CLUSTER_MACPRO51_IP | No | Mac Pro fallback IP | 192.168.1.183 |
| CLUSTER_SSH_RETRIES | No | Number of SSH retry attempts | 2 |
| CLUSTER_SSH_TIMEOUT | No | SSH connection timeout (seconds) | 5 |
| CLUSTER_INFERENCE_IP | No | Inference node fallback IP | 192.168.1.186 |
| CLUSTER_IP_CACHE_TTL | No | IP resolution cache TTL (seconds) | 300 |
| CLUSTER_MACSTUDIO_IP | No | Mac Studio fallback IP | 192.168.1.16 |
| CLUSTER_CPU_THRESHOLD | No | CPU usage % threshold for offloading | 40 |
| CLUSTER_MACBOOKAIR_IP | No | MacBook Air fallback IP | 192.168.1.172 |
| CLUSTER_MACPRO51_HOST | No | Mac Pro hostname | macpro51.local |
| CLUSTER_INFERENCE_HOST | No | Inference node hostname | completeu-server.local |
| CLUSTER_LOAD_THRESHOLD | No | Load average threshold for offloading | 4 |
| CLUSTER_MACSTUDIO_HOST | No | Mac Studio hostname | Marcs-Mac-Studio.local |
| CLUSTER_STATUS_TIMEOUT | No | Status check timeout (seconds) | 5 |
| CLUSTER_MACBOOKAIR_HOST | No | MacBook Air hostname | Marcs-MacBook-Air.local |
| CLUSTER_MEMORY_THRESHOLD | No | Memory usage % threshold for offloading | 80 |
| CLUSTER_SSH_CONNECT_TIMEOUT | No | Initial SSH connect timeout (seconds) | 2 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| cluster_bash | Execute bash command with automatic cluster routing. Commands are automatically routed to optimal nodes based on:
Heavy commands (make, cargo, pytest, docker, etc.) are automatically offloaded. Simple commands (ls, cat, echo) run locally for speed. Parameters:
Returns execution result with node info and output. |
| cluster_status | Get current cluster status and load distribution. Shows real-time metrics for all cluster nodes:
Use this to:
Returns JSON with status for each node. |
| offload_to | Explicitly route command to specific cluster node. Use when you need to:
Available nodes:
Parameters:
Returns execution result from specified node. |
| parallel_execute | Execute multiple commands in parallel across cluster. Distributes commands across available nodes for maximum parallelism. Use for:
Commands are automatically distributed based on node availability and load. Parameters:
Returns list of results, one per command, with execution details. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |