OrbStack MCP Server

通过 MCP（Model Context Protocol）协议控制 OrbStack，让 AI 助手直接管理你的 Docker 容器、Linux 虚拟机和 Kubernetes 集群。

前置要求

• macOS（OrbStack 仅支持 macOS）
• OrbStack 已安装
• Python >= 3.10
• orb 和 docker 命令在 PATH 中可用

安装

# 克隆或下载项目
cd orbstack-mcp

# 安装依赖
pip install -e .

使用方式

在 Claude Desktop 中配置

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "orbstack": {
      "command": "python",
      "args": ["-m", "orbstack_mcp.server"],
      "cwd": "/path/to/orbstack-mcp/src"
    }
  }
}

或者使用安装后的命令：

{
  "mcpServers": {
    "orbstack": {
      "command": "orbstack-mcp"
    }
  }
}

在 Claude Code 中配置

claude mcp add orbstack -- python -m orbstack_mcp.server

可用工具

系统管理

工具	说明
orbstack_status	查看 OrbStack 运行状态
orbstack_version	获取版本信息
orbstack_start	启动 OrbStack
orbstack_stop	停止 OrbStack

Linux 机器管理

工具	说明
orbstack_machine_list	列出所有 Linux 机器
orbstack_machine_create	创建新的 Linux 机器
orbstack_machine_start	启动 Linux 机器
orbstack_machine_stop	停止 Linux 机器
orbstack_machine_delete	删除 Linux 机器
orbstack_machine_info	查看机器详细信息
orbstack_machine_run	在机器中执行命令
orbstack_machine_push	推送文件到机器
orbstack_machine_pull	从机器拉取文件

Docker 容器管理

工具	说明
orbstack_docker_ps	列出容器
orbstack_docker_run	运行新容器
orbstack_docker_stop	停止容器
orbstack_docker_rm	删除容器
orbstack_docker_restart	重启容器
orbstack_docker_logs	查看容器日志
orbstack_docker_exec	在容器中执行命令
orbstack_docker_images	列出本地镜像
orbstack_docker_pull	拉取镜像
orbstack_docker_inspect	查看容器详情

Docker Compose

工具	说明
orbstack_compose_up	启动 Compose 项目
orbstack_compose_down	停止 Compose 项目
orbstack_compose_ps	查看 Compose 服务状态

Kubernetes

工具	说明
orbstack_k8s_start	启动 K8s 集群
orbstack_k8s_stop	停止 K8s 集群
orbstack_k8s_status	查看 K8s 状态

架构说明

本 MCP 服务器通过封装 orb / orbctl / docker CLI 命令实现对 OrbStack 的控制。 使用 stdio 传输方式，适合本地集成场景。

许可证

MIT