Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@OrbStack MCP Serverlist all my running docker containers and linux machines"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 运行状态 |
| 获取版本信息 |
| 启动 OrbStack |
| 停止 OrbStack |
Linux 机器管理
工具 | 说明 |
| 列出所有 Linux 机器 |
| 创建新的 Linux 机器 |
| 启动 Linux 机器 |
| 停止 Linux 机器 |
| 删除 Linux 机器 |
| 查看机器详细信息 |
| 在机器中执行命令 |
| 推送文件到机器 |
| 从机器拉取文件 |
Docker 容器管理
工具 | 说明 |
| 列出容器 |
| 运行新容器 |
| 停止容器 |
| 删除容器 |
| 重启容器 |
| 查看容器日志 |
| 在容器中执行命令 |
| 列出本地镜像 |
| 拉取镜像 |
| 查看容器详情 |
Docker Compose
工具 | 说明 |
| 启动 Compose 项目 |
| 停止 Compose 项目 |
| 查看 Compose 服务状态 |
Kubernetes
工具 | 说明 |
| 启动 K8s 集群 |
| 停止 K8s 集群 |
| 查看 K8s 状态 |
架构说明
本 MCP 服务器通过封装 orb / orbctl / docker CLI 命令实现对 OrbStack 的控制。
使用 stdio 传输方式，适合本地集成场景。
许可证
MIT
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.