orbstack mcp
MCP（模型上下文协议）服务器 OrbStack 它使Claude Code和Cursor等AI助手能够直接操作、监控和调试Docker容器。
使用Go构建 官方MCP Go SDK.
特性
- 12工具 全面的集装箱管理
- 与OrbStack的Docker运行时开箱即用
- 撰写项目意识（分组、项目级操作）
- 安全执行：无需shell注入，命令通过
exec.CommandContext - 用于与MCP客户端无缝集成的Stdio传输
安装
go install github.com/otsukatsuka/orbstack-mcp@latest或者从源代码构建：
git clone https://github.com/otsukatsuka/orbstack-mcp.git
cd orbstack-mcp
go build -o orbstack-mcp .配置
克劳德代码
添加到您的Claude Code MCP设置中(~/.claude/claude_desktop_config.json):
{
"mcpServers": {
"orbstack": {
"command": "orbstack-mcp"
}
}
}或者，如果从源代码构建：
{
"mcpServers": {
"orbstack": {
"command": "/path/to/orbstack-mcp"
}
}
}光标
添加到光标MCP设置(.cursor/mcp.json):
{
"mcpServers": {
"orbstack": {
"command": "orbstack-mcp"
}
}
}工具
核心
| 工具 | 说明 |
|---|---|
list_containers | 列出按Compose项目分组的容器。支持按项目名称过滤。 |
get_logs | 使用tail/stinch/until/timestamp选项获取容器日志。 |
search_logs | 使用正则表达式模式搜索日志。支持上下文行（如 grep -C). |
compose_logs | 获取Compose项目中所有服务的合并日志，前缀为服务名称。 |
调试
| 工具 | 说明 |
|---|---|
container_exec | 通过以下方式在容器内执行命令 sh -c （支持管道/重定向）。 |
restart_service | 使用可配置的超时重新启动容器。 |
container_stats | 获取CPU/内存/网络/块I/O统计快照。 |
检查和故障排除
| 工具 | 说明 |
|---|---|
container_inspect | 通过节过滤（env/ports/volumes/network/all）获取详细的容器信息。 |
container_health | 获取健康检查配置和最近的检查结果。 |
log_diff | 比较两个时间段之间的日志以进行回归调试。 |
作曲与活动
| 工具 | 说明 |
|---|---|
compose_up | 启动Compose项目（自动从容器中发现工作目录）。 |
compose_down | 使用可选的卷删除功能停止Compose项目。 |
container_events | 获取容器事件历史记录（启动/停止/死亡/重新启动/OOM）。 |
发展
先决条件
- 转到1.24+
- Docker（通过OrbStack）
运行测试
go test ./... -v构建
go build ./...许可证
Apache 2.0-请参阅 许可证.