OrbStack MCP Server

Instructions

Implementation Reference

• src/orbstack_mcp/server.py:920-942 (handler)

  The handler function that executes 'docker inspect' via '_run_docker' and formats the output.

  async def orbstack_docker_inspect(params: DockerContainerInput) -> str:
      """查看 Docker 容器的详细配置和状态信息。
  
      返回 JSON 格式的完整容器信息，包括网络、挂载、环境变量等。
  
      Args:
          params: 包含容器 ID 或名称
  
      Returns:
          str: 容器详细信息（JSON）
      """
      code, stdout, stderr = await _run_docker(["inspect", params.container])
      if code != 0:
          return _format_error(stderr)
      # 尝试美化 JSON 输出
      try:
          data = json.loads(stdout)
          if isinstance(data, list) and len(data) == 1:
              data = data[0]
          # 提取关键信息
          summary = {
              "Name": data.get("Name", ""),
              "State": data.get("State", {}).get("Status", ""),

• src/orbstack_mcp/server.py:910-919 (registration)

  The MCP tool registration for 'orbstack_docker_inspect'.

  @mcp.tool(
      name="orbstack_docker_inspect",
      annotations={
          "title": "查看容器详情",
          "readOnlyHint": True,
          "destructiveHint": False,
          "idempotentHint": True,
          "openWorldHint": False,
      },
  )