OrbStack MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| 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 |
|---|---|
| orbstack_statusA | 获取 OrbStack 的运行状态信息。 返回 OrbStack 是否正在运行、版本等基本状态。 Returns: str: OrbStack 状态信息 |
| orbstack_versionA | 获取 OrbStack 版本号。 Returns: str: OrbStack 版本信息 |
| orbstack_startA | 启动 OrbStack 服务。 如果 OrbStack 已在运行，此操作无副作用。 Returns: str: 启动结果 |
| orbstack_stopA | 停止 OrbStack 服务。 这将停止所有运行中的容器和 Linux 机器。 Returns: str: 停止结果 |
| orbstack_machine_listA | 列出所有 OrbStack Linux 机器及其状态。 显示机器名称、发行版、架构和运行状态。 Returns: str: 机器列表信息 |
| orbstack_machine_createA | 创建一个新的 Linux 虚拟机。 支持 ubuntu, debian, fedora, arch, alpine 等多种发行版。 在 Apple Silicon 上可通过 arch 参数指定 amd64 来运行 Intel 架构。 Args: params: 创建参数，包括发行版名称、可选的机器名和架构 Returns: str: 创建结果 |
| orbstack_machine_startC | 启动指定的 Linux 机器。 Args: params: 包含机器名称 Returns: str: 启动结果 |
| orbstack_machine_stopB | 停止指定的 Linux 机器。 Args: params: 包含机器名称 Returns: str: 停止结果 |
| orbstack_machine_deleteA | 删除指定的 Linux 机器。 警告: 此操作不可撤销，机器中的所有数据将被永久删除。 Args: params: 包含机器名称 Returns: str: 删除结果 |
| orbstack_machine_infoB | 获取指定 Linux 机器的详细信息。 包括发行版、架构、状态、IP 地址等。 Args: params: 包含机器名称 Returns: str: 机器详细信息 |
| orbstack_machine_runA | 在 Linux 机器中执行命令并返回输出。 可以指定目标机器和执行用户。不指定机器时使用默认机器。 Args: params: 包含要执行的命令、可选的机器名和用户 Returns: str: 命令执行输出 |
| orbstack_machine_pushC | 将文件从 macOS 推送到 Linux 机器。 Args: params: 包含源文件路径、可选的目标路径和机器名 Returns: str: 传输结果 |
| orbstack_machine_pullC | 从 Linux 机器拉取文件到 macOS。 Args: params: 包含源文件路径、可选的目标路径和机器名 Returns: str: 传输结果 |
| orbstack_docker_psA | 列出 Docker 容器。 默认只显示运行中的容器，设置 all=True 显示全部。 Args: params: 包含是否显示所有容器的选项 Returns: str: 容器列表（格式化表格） |
| orbstack_docker_runB | 创建并运行一个新的 Docker 容器。 支持端口映射、卷挂载、环境变量等配置。 Args: params: 容器运行参数 Returns: str: 容器 ID 或运行输出 |
| orbstack_docker_stopA | 停止运行中的 Docker 容器。 Args: params: 包含容器 ID 或名称 Returns: str: 停止结果 |
| orbstack_docker_rmA | 删除 Docker 容器。 容器必须已停止才能删除。如需强制删除运行中的容器请先停止。 Args: params: 包含容器 ID 或名称 Returns: str: 删除结果 |
| orbstack_docker_logsC | 获取 Docker 容器的日志输出。 Args: params: 包含容器标识和日志行数 Returns: str: 容器日志 |
| orbstack_docker_execC | 在运行中的 Docker 容器中执行命令。 Args: params: 包含容器标识和要执行的命令 Returns: str: 命令输出 |
| orbstack_docker_imagesB | 列出本地所有 Docker 镜像。 Returns: str: 镜像列表（格式化表格） |
| orbstack_docker_pullC | 从镜像仓库拉取 Docker 镜像。 Args: params: 包含镜像名称 Returns: str: 拉取结果 |
| orbstack_docker_restartC | 重启 Docker 容器。 Args: params: 包含容器 ID 或名称 Returns: str: 重启结果 |
| orbstack_docker_inspectB | 查看 Docker 容器的详细配置和状态信息。 返回 JSON 格式的完整容器信息，包括网络、挂载、环境变量等。 Args: params: 包含容器 ID 或名称 Returns: str: 容器详细信息（JSON） |
| orbstack_k8s_startA | 启动 OrbStack 内置的 Kubernetes 集群。 OrbStack 提供轻量级的单节点 K8s 集群。 Returns: str: 启动结果 |
| orbstack_k8s_stopB | 停止 OrbStack 的 Kubernetes 集群。 Returns: str: 停止结果 |
| orbstack_k8s_statusA | 查看 OrbStack Kubernetes 集群的状态。 Returns: str: K8s 集群状态 |
| orbstack_compose_upA | 使用 Docker Compose 启动服务。 在指定目录中执行 docker compose up -d。 Args: params: 包含项目目录和可选的服务名 Returns: str: 启动结果 |
| orbstack_compose_downC | 使用 Docker Compose 停止并移除服务。 Args: params: 包含项目目录 Returns: str: 停止结果 |
| orbstack_compose_psA | 查看 Docker Compose 项目中各服务的运行状态。 Args: params: 包含项目目录 Returns: str: 服务状态列表 |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 29 tools
Each tool has a clearly distinct purpose with no ambiguity. The tools are organized into logical groups (Docker, Compose, Kubernetes, Linux machines, and core OrbStack operations) with each tool performing a specific, well-defined action on a specific resource. For example, orbstack_docker_stop, orbstack_docker_restart, and orbstack_docker_rm are clearly differentiated in their lifecycle management functions.
All tools follow a perfectly consistent naming pattern: 'orbstack_' prefix + resource category (docker/compose/k8s/machine) + action verb (in snake_case). This creates a predictable hierarchy (e.g., orbstack_docker_ps, orbstack_docker_run, orbstack_machine_list, orbstack_machine_start) that makes the tool set immediately understandable and navigable.
With 29 tools, the count feels heavy for a single server, though it covers multiple domains (Docker, Compose, Kubernetes, VM management, and core operations). While each tool appears useful, the high number could overwhelm agents and suggests potential for consolidation (e.g., some Docker operations might be combined with parameters). It's borderline excessive but justified by the broad scope.
The tool set provides complete CRUD/lifecycle coverage for all supported domains. For Docker: full container/image management (run, stop, restart, rm, ps, images, inspect, logs, exec, pull). For Linux machines: create, delete, start, stop, list, info, run commands, push/pull files. For Compose/Kubernetes: up/down/ps and start/stop/status respectively. Core OrbStack operations (start/stop/status/version) round out the surface with no apparent gaps.