AI导哈

容器管理协议服务器

OrbStack-MCP是一个用于AI助手直接操作、监控和调试Docker容器的模型上下文协议服务器。

  • by otsukatsuka
  • Go
  • 本地部署
  • 4 星标
  • 更新于
在 GitHub 查看 otsukatsuka/orbstack-mcp

使用说明

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-请参阅 许可证.

相关 MCP